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PREFACE 



This manual describes CONTROL DATA® Sort/Merge 
Version 5.0, a generalized sorting and merging 
utility. As described in this publication, Sort/ 
Merge Version 5.0 operates under control of the 
NOS 2 and the NOS/BE 1 operating systems for the 
I CDC® CYBER 170 and CYBER 180 Computer Systems. 

This manual is written for the application program- 
mer. You are assumed to be familiar with the CDC 
operating system installed at your site and, if you 
are using procedure calls to Sort/Merge, with the 
calling language. 

You can find related information in the publica- 
tions listed below; the publications are listed 



within groupings that indicate relative importance 
to you. 

The NOS manual abstracts and the NOS/BE manual 
abstracts are pocket-sized manuals containing brief 
descriptions of the contents and intended audience 
of all NOS and NOS product set manuals and NOS/BE 
and NOS/BE product set manuals, respectively. The 
manual abstracts can be useful in determining which 
manuals are of greatest interest to you. The 
Software Publications Release History serves as a 
guide in determining which revision level of 
software documentation corresponds to the 
Programming System Report (PSR) level of software 
installed at your site. 



The following manuals are of primary interest: 



Publication 



COBOL Version 5 Reference Manual 



Publication 
Number 



60497100 



NOS 2 



NOS/BE 1 
X 



CYBER Record Manager 

Basic Access Methods Version 1.5 

Reference Manual 

FORTRAN Version 5 Reference Manual 

SORT /MERGE Version 5 Instant 



60495700 


X 


X 


60481300 


X 


X 


60484900 


X 


X 



The following manuals are of secondary interest: 



Publication 



INTERCOM Version 5 Reference Manual 



Publication 
Number 

60455010 



NOS 2 



NOS/BE 1 



Network Products 

Remote Batch Facility Version 1 

Reference Manual 

NOS Version 2 Manual Abstracts 

NOS Version 2 Reference Set, Volume 1 
Introduction to Interactive Usage 

NOS Version 2 Reference Set, Volume 3 

System Commands 

NOS/BE Version 1 Manual Abstracts 
NOS/BE Version 1 Reference Manual 
Software Publications Release History 



60499600 


X 


60485500 


X 


60459660 


X 


60459680 


X 


84000470 




60493800 




60481000 





CDC manuals can be ordered from Control Data Corporation, Literature and 
Distribution Services, 308 North Dale Street, St. Paul, Minnesota 55103. 

This product is intended for use only as described in this 
document. Control Data cannot be responsible for the proper 
functioning of undescribed features or parameters. 



60484800 D 



v/vi 



CONTENTS 



NOTATIONS 



PROCEDURE CALLS 



5-1 



1. GENERAL DESCRIPTION 

Functions and Features 

Configuration and Software Relationships 

Job Flow 



2. SORT KEYS 

Definition 
Describing Sort Keys 

Key Length and Position 
Key Type 

Collating Sequences 
Numeric Data Formats 
Sort Order 





SM5S0RT 


1-1 


SM5MERG 




SM5FR0M 


1-1 


SM5T0 


1-2 


SM5KEY 


1-2 


SM5E 




SM5EL 




SM5ENR 


2-1 


SM5FAST 




SM5N0DA 


2-1 


SM50FL 


2-1 


SM50MRL 


2-1 


SM50WNn 


2-1 


SM5RETA 


2-2 


SM5SEQx 


2-2 


SM5ST 


2-5 


SM5SUM 




SM5END 



5-1 
5-2 
5-2 
5-2 
5-2 
5-3 
5-3 
5-3 
5-4 
5-4 
5-4 
5-4 
5-4 
3-4 
5-5 
5-5 
5-b 
5-7 



3. CONTROL STATEMENT SORTS OR MERGES 

S0RT5 Control Statement 
MERGE Control Statement 
Directive Files 
Sort/Merge Parameters 

FROM 

TO 

KEY 

DIR 

L 

E 

EL 

DIALOG 

ENR 

OWNF 

OWNFL 

OWNMRL 

OWNn 

RETAIN 

SEQx 

STATUS 

SUM 

VERIFY 

FASTIO 
Specifying Parameters by Position 
FILE Control Statement 
Specifying Maximum Record Length 
Field Length Requirements 
Listings 



3-1 

3-1 

3-1 

3-1 

3-2 

3-2 

3-2 

3-2 

3-3 

3-3 

3-4 

3-4 

3-4 

3-4 

3-4 

3-5 

3-5 

3-5 

3-5 

3-5 

3-7 

3-8 

3-9 

3-9 

3-9 

3-10 

3-11 

3-11 

3-11 



t>. COBOL INTERFACE b-1 

C0B0L5 Control Statement Option b-1 

Direct Calls b-1 



7. OWNCODE ROUTINES 7-1 

Specifying Owncode Routines 7-1 

Owncode Routine Parameters 7-1 

Processing Input Records 7-2 

Processing Input Files 7-3 

Processing Output Records 7-3 

Processing Output Files 7-4 
Processing Records With 

7-4 



8-1 



Control Statement Sort on One Key 8-1 

Sort Specification Using Interactive Dialog b-1 

Control Statement Sort on Multiple Keys 8-3 

Control Statement Merge 8-3 

Creating and Using a Directive File 8-4 

SUM Parameter Use 8-4 

A Sort Using Procedure Calls 8-7 



Owncode 1 




Owncode 2 




Owncode 3 




Owncode 4 




Owncode 5 




Equal Keys 


8. EXAMPI 


JES 



4. INTERACTIVE USE 

Terminal Access to Sort/Merge 

Logging in Under NOS 

Logging in Under NOS/BE 
Interactive Dialog 
Interactive Commands 

HELP 

RESTART 

QUIT 
Specifying Parameters Interactively 
Logging Out 



4-1 

4-1 
4-1 
4-1 
4-2 
4-3 
4-3 
4-3 
4-3 
4-5 
4-5 



APPENDIXES 

A Character Data Input, Output, and 

Central Memory Representation A-l 

B Diagnostics B-1 

C Glossary C-l 

D Sort/Merge Parameter Summary D-l 

E Interactive Dialog K-l 

F Sort/Merge 5, Sort/Merge 4 Comparison F-l 



INDEX 



60484800 D 



FIGURES 



1-1 


Batch Job Flow 




1-3 


1-2 


Interactive Job Flow 




1-4 


2-1 


Internal Representation 


of Character 






and Noncharacter Data 




2-2 


3-1 


FROM Parameter Format 




3-2 


3-2 


TO Parameter Format 




3-2 


3-3 


KEY Parameter Format 




3-3 


3-4 


DIR Parameter Format 




3-3 


3-5 


L Parameter Format 




3-3 


3-6 


E Parameter Format 




3-4 


3-7 


EL Parameter Format 




3-4 


3-8 


DIALOG Parameter Format 




3-4 


3-9 


ENR Parameter Format 




3-4 


3-10 


OWNF Parameter Format 




3-4 


3-11 


OWNFL Parameter Format 




3-5 


3-12 


OWNMRL Parameter Format 




3-5 


3-13 


OWNn Parameter Format 




3-5 


3-14 


RETAIN Parameter Format 




....3-5.- 


3-15 


SEQx Parameter Formats 




3-5 


3-16 


STATUS Parameter Format 




3-7 


3-17 


SUM Parameter Format 




3-8 


3-18 


SUM Parameter Example 




3-9 


3-19 


VERIFY Parameter Format 




3-9 


3-20 


FASTIO Parameter Format 




3-9 


3-21 


FILE Control Statement Format 


3-10 


4-1 


NOS Login Example 




4-1 


4-2 


NOS/BE Login Example 




4-2 


4-3 


Incorrect Response Example 


4-3 


4-4 


Output File Disposition 


Example 


4-4 


4-5 


Interactive Command Example 


4-4. 


4-6 


Interactive Parameter Specification 






Examp le 




4-5 


5-1 


SM5S0RT Format 




5-1 


5-2 


SM5MERG Format 




5-2 


5-3 


SM5FR0M Format 




5-2 


5-4 


SM5T0 Format 




5-2 


5-5 


SM5KEY Format 




5-2 


5-6 


SM5E Format 




5-3 


5-7 


SM5EL Format 




5-3 


5-8 


SM5ENR Format 




5-3 


5-9 


SM5FAST Format 




5-4 


5-10 


SM5N0DA 




5-4 


5-11 


SM50FL Format 




5-4 


5-12 


SM50MRL Format 




5-4 


5-13 


SM50WNn Format 




5-4 


5-14 


SM5RETA Format 




5-5 


5-15 


SM5SEQx Formats 




5-5 


5-16 


SM5ST Format 




5-5 


5-17 


SM5SUM Format 




5-6 


5-18 


SM5SUM Procedure Call Example 


5-7 



5-19 SM5END Format 

6-1 C0B0L5 Control Statement Example 

7-1 Owncode Routine Call and Subroutine 

Statement Formats 
7-2 Owncode Routine Record Flow 
8-1 File UNIVER Record Layout 
8-2 File UNIVER 
8-3 Job Structure for Sorting File UNIVER 

on Last Name 
8-4 File UNIVER Sorted on Last Name 
8-5 Interactive Dialog Example 
8-6 Job Structure for Control Statement 

Sort on Multiple Keys 
8-7 File UNIVER Sorted on Multiple Keys 
8-8 Input Files for Control Statement Merge 
8-9 Job Structure for Control Statement 

Merge 
8-10 Merged File NEWU 
8-11 Creating a Directive File 

8-12 Using a Directive File (NOS) 

8-13 File NUMFIL 

8-14 Output From Sort Using a Directive File 

8-15 File GRADES Record Layout 

8-16 File GRADES 

8-17 Interactive Parameter Specification 

for SUM Example 
8-18 Output From SUM Example 
8-19 Job Structure for Sort Called From a 

FORTRAN Program 
8-20 FORTRAN Program With Sort/Merge 

Procedure Calls 
8-21 Owncode Routine 
8-22 Output From FORTRAN Program 



TABLES 

2-1 Data in Sort Key Fields 

2-2 Predefined Collating Sequences 

2-3 Numeric Data Formats 

2-4 Sign Overpunch Representation 

3-1 $CHAR(n) Character Numbers 

3-2 SEQS Parameter Summary 

3-3 Error Level Codes, STATUS Parameter 

3-4 Parameter Positional Order 

3-5 File Characteristics 

5-1 Result Array Format 

5-2 Error Level Specification 

5-3 Error Level Codes, SM5ST Call 

7-1 Owncode Routine Summary 



5-7 
6-1 

7-1 
7-3 
8-1 
8-1 

8-2 
8-2 
8-2 

8-3 
8-3 
8-3 

8-4 
8-4 
8-5 
8-5 
8-6 
8-b 
8-6 
8-6 

8-7 
8-7 

8-8 

8-8 
8-9 
8-9 



2-2 

2-3 

2-4 

2-5 

3-6 

3-7 

3-8 

3-10 

3-11 

5-1 

5-3 

5-6 

7-2 



viii 



60484800 D 



NOTATIONS 



Unless otherwise specified, the conventions de- 
scribed in the following paragraphs are used 
throughout this manual in parameter and procedure 
call formats, examples, and diagnostic messages. 

UPPERCASE Uppercase letters indicate words, 
acronyms, or mnemonics required as 
input by Sort/Merge or produced as 
output by Sort/Merge. Parameter 
keywords and interactive commands 
are included in this category. 

lowercase Lowercase letters Indicate words 
or symbols that you must supply. 

Ellipsis in a parameter or pro- 
cedure call format indicates that 
omitted portions of the format can 
be repeated. 



[ 1 



Brackets indicate an optional por- 
tion of a parameter or procedure 
call format. 



Two periods in a parameter format 
indicate a range of letters or 
digits . 



Delta indicates a space (blank). 



1 I 2 I Boxes indicate character positions 
in storage. 



Unless otherwise indicated, all numbers in text are 
decimal values. 
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GENERAL DESCRIPTION 



Sort/Merge Version 5 is a set of powerful and 
efficient routines that provides high-speed sorting 
or merging of records with a single control state- 
ment. This section introduces the features of 
Sort/Merge and provides you with an overview of the 
Sort/Merge relationship with system software. 



FUNCTIONS AND FEATURES 

The purpose of sorting is to arrange items in 
order; the purpose of merging is to combine two or 
more sets of preordered items. Using Sort/Merge, 
records are rearranged in the order you specify, or 
two or more sorted files are combined into one 
file. Sort/Merge offers the following features: 

• A sort or merge specification with a single 
control statement 

• An optional directive file for sort or merge 
specification 

• The capability of sorting or merging records 
from as many as 100 files with one call to 
Sort /Merge 

• Character and noncharacter sort key types 

• Five predefined collating sequences 

• User-defined collating sequences 

• Summing of numeric fields 

• Sorting of any CYBER Record Manager (CRM) 
sequential file and any record type (except U) 

• A tutorial dialog for interactive sort or merge 
specification 

• A set of procedures for sort or merge proc- 
essing from within a program written in FORTRAN 
or some other language 

• Interface with COBOL programs through a C0B0L5 
control statement option or direct calls 

• Owncode routines to insert, substitute, modify, 
or delete records during Sort/Merge processing 

These features are described briefly in the fol- 
lowing paragraphs. 

Sorts are initiated with the S0RT5 control state- 
ment; merges are initiated with the MERGE control 
statement. You specify processing requirements for 
the sort or merge with parameters in the respective 
control statement. Merge processing requires files 
that have already been sorted. Sort/Merge gener- 
ates code based on the parameters and parameter 
values that you include in the S0RT5 or MERGE 
control statement. 



The S0RT5 or the MERGE control statement can be up 
to 240 characters in length. You can specify more 
complex sorts or merges by using a directive file 
for additional parameters. Sort/Merge reads the 
parameters in a directive file after all of the 
parameters in the control statement have been 
read. Using a single control statement to specify 
your sort or merge provides simplicity and elimi- 
nates the necessity of creating, saving, and 
subsequently retrieving directive files. Directive 
files, on the other hand, provide standardization 
of installation parameters and collating sequences. 

Records are sorted or merged on fields of data 
within each input record; the fields are called 
sort keys. Sort keys can be 6-bit character data, 
signed or unsigned binary integers, or floating- 
point numbers. Data can be sorted or merged 
according to a predefined or user-defined collating 
sequence for character data, or according to 
numeric value for numeric data. Numeric data can 
be signed or unsigned. 

Records with equal sort key fields can be combined 
into one new record. You can specify that numeric 
fields be added to the corresponding fields in the 
other records with equal keys. The one resultant 
record contains the key fields and the numeric 
fields that are the sums of the specified numeric 
fields in all the records with equal keys; data 
fields that are not key or sum fields are set to 
the corresponding fields in one of the old records. 

Sort/Merge uses CRM file processing and input/ 
output capabilities. Any of the CRM sequential 
files or record types (except U) can be sorted or 
merged; this includes both fixed and variable 
length records. Because Sort/Merge uses CRM, the 
characteristics of files input to Sort/Merge and 
files output from Sort/Merge must be described to 
CRM with FILE control statements unless default 
characteristics apply. 

You can specify any sort or merge from your termi- 
nal by entering the S0RT5 or MERGE control state- 
ment and processing parameters. An interactive 
dialog is also available to guide you, step by 
step, through your sort or merge specification. 
The processing options are presented, and you 
choose the option you want as well as identify your 
files and sort key fields to Sort/Merge. Several 
interactive commands are available to control the 
use of the interactive dialog. During the dialog, 
you can obtain an explanation of Sort/Merge usage 
by entering HELP at your terminal. 

A set of procedures exists that allows you to 
initiate a sort or merge from within your program 
written in FORTRAN or some other lanquage. The 
same processing options are available using calls 
to the procedures as are available using the S0RT5 
or the MERGE control statement; the procedure calls 
closely correspond to the Sort/Merge parameters. 
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A C0B0L5 control statement option exists that 
allows you to use Sort/Merge 5. If you specify 
S0RT5 in your C0B0L5 control statement, Sort/ 
Merge 5 is used when the COBOL SORT or MERGE state- 
ment in your program executes. 

You can write routines, called owncode routines, to 
insert, substitute, modify, or delete records 
during Sort/Merge processing. Owncode routines are 
subroutines written in FORTRAN or some other 
language. The routines must be compiled; the file 
containing the compiled routines is loaded during 
your sort or merge. Depending on the exit number 
you specify, owncode routines are executed to 
process input records, output records, or records 
with equal keys. You can use owncode routines with 
control statement sorts or merges, or with proce- 
dure calls to Sort/Merge. 



CONFIGURATION AND SOFTWARE 
RELATIONSHIPS 

The hardware configuration needed to support Sort/ 
Merge Version 5 is the same as the minimum config- 
uration required for the NOS or NOS/BE operating 
| system. One CDC CYBER 170 or 180 series host 
computer, together with peripheral processing units 
and disk subsystem is necessary. For installation, 
one tape unit is needed. Additionally, the inter- 
active feature of Sort/Merge requires one 255x 
series communication subsystem. 

Sort/Merge Version 5 resides in a library named 
SRT5LIB on the NOS or NOS/BE operating system. 
Sort/Merge requires only the basic NOS or NOS/BE 
software. Sort/Merge interfaces with CYBER Record 
Manager, which is one of the standard products 
released as part of both operating systems. 



Interactive use of Sort/Merge requires the Inter- 
active Facility (IAF) Version 1 under NOS or 
INTERCOM Version 5 under NOS/BE. IAF in turn 
interfaces with the network software Network Access 
Method (NAM). The NOS Version 2 Reference Set, 
Volume 1 (for NOS users) or the INTERCOM reference 
manual (for NOS/BE users) contains information 
concerning terminal requirements. 



JOB FLOW 

You can use Sort/Merge for batch processing or 
interactively. For batch sort jobs, records to be 
sorted can be in permanent files, input in the same 
job with your S0RT5 control statement and param- 
eters, or supplied by an owncode routine. For 
merge processing, records ~ mustr be in" presorted 
files assigned to the job and named in the MERGE 
control statement. Sort/Merge uses CYBER Record 
Manager for input and output. Sorted or merged 
records can be written to a file and saved, listed 
by a printer, or processed by an owncode routine. 
Figure 1-1 illustrates batch job flow. 



Interactively, records to be sorted or merged can 
be in local files or in permanent files you assign 
to your job; records to be sorted can also be 
supplied by an owncode routine. You can enter the 
S0RT5 or MERGE control statement and processing 
parameters from your terminal, or you can use the 
interactive dialog to specify your sort or merge. 
At the end of the sort or merge, records are in a 
local file that can be displayed at your terminal, 
saved as a permanent file, or listed by a printer; 
output records can also be processed by an owncode 
routine. Figure 1-2 illustrates interactive 
job flow. 



1-2 



60484800 D 



A. Sort 



Permanent 

file to be 

sorted 



Records supplied 

by an owncode 

routine 



Sort 
Parameters 




CYBER 
J Record | 

. Manager , 



Sort/Merge 



INPUT 

file to be 

sorted 




Sorted file 

saved as a 

permanent file 



Sorted file 
printed out 



Sorted records 
processed by an 
owncode routine 



B. Merge 




Sorted files 

to be 

merged 




1 CYBER ' 
| Record 
Manager 



Sort/Merge 



Merge 
Parameters 




Merged file 

saved as a 

permanent file 



Merged file 
printed out 



Merged records 
processed by an 
owncode routine 



Figure 1-1. Batch Job Flow 



60484800 A 



1-3 



A. Sort 



Records supplied 

by an owncode 

routine 




' CYBER ' 
| Record | 
. Manager 



Sort/Merge 




Sorted file 

saved as a 

permanent file 



Sorted records 
processed by an 
owncode routine 



B. Merge 




Sorted files 

to be 

merged 




• CYBER ' 

| Record I 

Manager . 



Interactive 
I merge specification 



| IAF or | 

-. INTER- - 

1 COM ' 

I I 



Sort/Merge 




Merged file 

saved as a 

permanent file 



Merged file 
printed out 



Merged records 
processed by an 
owncode routine 



Figure 1-2. Interactive Job Flow 



1-4 



60484800 B 



SORT KEYS 



All sort or merge operations are based on the 
ordering of values assigned to the data to be 
sorted or merged, which are called sort keys. This 
section includes an explanation of sort keys and a 
discussion of the information you must supply to 
describe sort keys to Sort/Merge. 

DEFINITION 

A sort key is a field of data within each record in 
an input file to be sorted or in a presorted file 
to be merged with one or more other files. The 
field is used by Sort/Merge to determine the order 
in which records are output. A file can be sorted 
or merged on more than one field of data; key 
fields must occur in the same position and be the 
same length in each record, and the total number of 
key characters must be less than 256 (if you also 
specify sum fields , the total number of characters 
in the key and sum fields together must be less 
than 256). Sort keys in files with variable length 
records cannot extend beyond the length of the 
shortest record in the file; the sort key field 
must be present in every record. For example, if 
the records range from a minimum of 25 characters 
to a maximum of 80 characters, all sort keys must 
be in the first 25 characters. 

The first key you specify is the most important key 
and is called a major sort key. The keys you 
specify after the first key are of lesser 
importance and are called minor sort keys. Each 
sort key describes the length of the field, the 
position of the field within each record, the type 
of data expected in that field, and the effect of 
that data on the sort order. When you specify 
multiple sort keys, the keys can differ as to type 
of data, collating sequence, and sort order. The 
alignment of data in sort keys is important. 
Character data must be left-justified in the field; 
numbers must be right-justified in the field. 

An example of a file with multiple sort keys is a 
university student file with a record for each 
student. Each record includes the last name and 
first and middle initials, the student number, the 
date of birth, the field of study, the grade point 
average, and a code representing class (freshman, 
sophomore, junior, senior); all the fields are 
written with character data. The file could be 
maintained with the student number as the major 
key - records are normally retrieved by specifying 
the student number. The file can be sorted by the 
name in standard alphabetic order when a list of 
student names is needed. 

When a university department needs to know which 
students are majoring in fields within the 
department, the file can be sorted on the field of 
study. The same sort can specify the name as a 
minor key so that records with the same field of 
study are also sorted in alphabetic order by the 
name. The file can be sorted by the class code as 
the major key, and by the grade point average in 
descending numeric order as a minor key to give a 



list by class with the students having the highest 
grade point average at the beginning of the list. 

DESCRIBING SORT KEYS 

You must describe to Sort/Merge every field of data 
that you want used as a sort key. Sort key 
descriptions include the following information: 

• Starting location of the key within the record 

• Key length 

• Type of data in the key field 

• Sort order 

You describe sort keys with either the KEY 
parameter in a control statement or directive file, 
or with the SM5KEY procedure call. The options and 
defaults for describing sort keys are discussed in 
the following paragraphs. 

KEY LENGTH AND POSITION 

You define key field length and position by 
specifying the first byte or bit of the field and 
either the number of bytes or bits in the field 
(length of the field), or the last byte or bit of 
the field. The leftmost byte and the leftmost bit 
in a record are counted as number 1. For character 
data, each character is six bits and occupies one 
byte. For example, if you want to specify the name 
of the university student file as a sort key, and 
the name field is the leftmost field in the record, 
you specify the first byte as 1. If the name field 
is 20 characters long, you specify length as 20. 

Sort/Merge interprets the integers you specify for 
key length and position as bit numbers when the key 
type (discussed later in this section) specifies 
bits; otherwise, byte numbers are assumed. Unless 
the SEQA parameter or SM5SEQA procedure is used, 
key fields can overlap one another. No default 
exists for the starting location of a key within a 
record; you must specify the starting location. If 
you do not specify the length of a key, length 
defaults to 1. 

KEY TYPE 

You specify the type of data in a key field with 
the name of a collating sequence or with the name 
of a numeric data format. The data in a key field 
can be character or noncharacter. Character data 
is represented in the computer as display code 
values. To indicate the key type for character 
data, you specify the name of a collating sequence 
or, for numeric character data, the name of a 
numeric data format. Noncharacter data is 
represented in the computer as binary values. To 
indicate the key type for noncharacter data, you 
specify the name of a numeric data format. 
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Figure 2-1 illustrates the difference between the 
internal representation of character and nonchar- 
acter data. Table 2-1 summarizes character and 
noncharacter data types and the associated sort 
key type. 



A. Character data 



— 


1 


2 


3 


4 



Octal equivalent of display code character 
29 24 18 .. ..12 6L Q 



46 


34 


35 


36 


37 



B. Noncharacter data 





-1234 






Octal equivalent of binary value 

59 






77. ..775455 











Figure 2-1. Internal Representation of Character 
and Noncharacter Data 



If a sort key field contains any characters that 
are not meaningful for the key type you specify (an 
alphabetic character in a field defined as a 
numeric key for example), the sort order for that 
key field in that record is undefined. In the 
output file, the data for that key field in that 
record is also undefined. The record is still 
sorted according to any other sort keys you have 
specified. 



The collating sequences and numeric data formats 
you can specify are discussed in the following 
paragraphs . 



Collating Sequences 

A collating sequence determines the precedence 
given to each character in relation to the other 
characters. You specify a collating sequence for 
character data to determine the sort order . The 
data must be display code characters. 



Five predefined collating sequences are available 
to you as a Sort/Merge user: ASCII6, COB0L6, 
DISPLAY, EBCDIC6, and INTBCD. The default col- 
lating sequence is ASCII6. Table 2-=2 shows the 
predefined collating sequences. 



If none of the predefined collating sequences 
orders data as you would like, you can define a 
nonstandard collating sequence. If you are using 
control statement calls to Sort/Merge, you define 
your own collating sequence with SEQx parameters in 
the S0RT5 or MERGE control statement. If you are 
using the procedure calls, you define your own 
collating sequence with SM5SEQx procedure calls. 



Numeric Data Formats 

Numeric data can appear in a key field in one of 
the formats listed in table 2-3. Numeric data can 
be signed or unsigned. For character numeric data 
that is signed, the sign can be a floating sign, an 
overpunch representation over the leading (left- 
most) digit, a leading separate character, an over- 
punch representation over the trailing (rightmost) 
digit, or a trailing separate character. 

A floating sign is a negative sign embedded between 
leading blanks and the numeric characters; leading 
zeros must be converted to blanks. Positive values 
in this format are not signed. The following 
examples are valid floating sign formats: 

AA - 1 

AAA 1 

A A A 

12 3 4 



TABLE 2-1. DATA IN SORT KEY FIELDS 



Type 


Internal 
Representation 


Data 
in Field 


Type 
Specified by 


Data Ordered 
According to 






Alphabetic 


Name of a collating 
sequence 


Specified 
collating 
sequence 


Character 


Display code 


Numeric 


Name of a collating 
sequence 


Specified 
collating 
sequence 


p 






Name of a numeric 
data format 


Numeric 
value 


Noncharacter 


Binary value 


Numeric 


Name of a numeric 
data format 


Numeric 
value 
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TABLE 2-2 


. PREDEFINED COLLATING SEQUENCES 










Collating 
Sequence 


ASCII6 


C0B0L6 


DISPLAY 


EBCDIC6 


INTBCD 




Decimal 


Octal 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 

Code 


Graphics 


CDC 

INTBCD 
Code 
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00 


blank 


55 
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02 




03 


03 


# 


60 


[ 


61 


C 


03 


( 


51 


3 


03 
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TABLE 2-3. NUMERIC DATA FORMATS 



Name 



NUMERIC LO 



NUMERIC LS 



NUMERIC TO 



NUMERIC TS 



NUMERIC NS 



NUMERIC FS 



BINARY 



BINARY BITS 



Data Type 



Numeric characters 



Numeric characters 



Numeric characters 



Numeric characters 



Numeric characters 



Leading blanks, 
numeric characters 



INTEGER 



INTEGER BITS 



REAL 



Binary integer 



Binary integer 



One ' s complement 
binary integer 



One's complement 
binary integer 



Normalized binary 
real or floating- 
point number 



Sign 



Leading overpunch 



Leading separate 



Trailing overpunch 



Trailing separate 



None 



- sign for negative 
values; a + character 
is not allowed 



Comments 



None 



None 



Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 



Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 



Signed 



All characters are decimal digits except the 
leading character, which indicates a sign by 
an overpunch. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits except the 
leading character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
.n\u»eric.yalue_xtth_neiatiye..Mr«_pjdered 
before positive zero. 

All characters are decimal digits except the 
trailing character, which indicates a sign by 
an overpunch. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits except the 
trailing character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 



All characters are decimal digits, 
ordered according to numeric value. 



Data is 



The field contains leading blanks (leading 
zeros must be converted to blanks); if the 
value is negative, the right-most leading 
blank must be converted to a minus sign. If 
the field contains no leading blanks, the 
value must be positive. This format is 
equivalent to the FORTRAN I format. Data is 
ordered according to numeric value with 
negative zero ordered before positive zero. 

The field starts and ends on character bound- 
aries. Data is ordered according to numeric 
value . 

The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value. 

The field starts and ends on character bound- 
aries. Data is ordered according to numeric 
value with negative zero ordered before posi- 
tive zero. 

The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

The field occupies a full computer word and 
is aligned on word boundaries. Data is 
ordered according to numeric value with all 
forms of zero ordered equally. The order of 
indefinite values is undefined. 
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The following examples are not valid floating sign 
formats: 

A A 1 Leading zero not allowed 

A - 1 Leading zero not allowed 

+12 3 Positive sign not allowed 

A A A A All blank field not allowed 



the collating sequence you specify. For numeric 
keys sorted in descending order, the record having 
the key with the lowest value is written last on 
the output file. Descending character keys are 
sorted in reverse order of the collating sequence 
you specify. The default sort order is ascending. 

TABLE 2-4. SIGN OVERPUNCH REPRESENTATION 



A negative sign overpunch is equivalent to 
overstriking a digit with a - , which is a punch in 
row 11. A positive sign overpunch is equivalent to 
overstriking a digit with a + , which is a punch in 
row 12. When a signed overpunch digit is received 
as input, the digit is punched as indicated in the 
second column of table 2-4. When a signed 
overpunch digit is displayed as output, the digit 
appears as indicated in the third column of 
table 2-4. Noncharacter numeric data can be signed 
or unsigned binary integers or normalized floating- 
point numbers. 

You define numeric key fields by specifying the 
first byte of the field and either the length of 
the field or the last byte of the field. For types 
BINARY_BITS and INTEGER_BITS , you specify the first 
bit position of the field and either the length of 
the field in bits or the last bit of the field. 



SORT ORDER 

The order for sorting keys is ascending or 
descending. For numeric keys sorted in ascending 
order, the record having the key with the highest 
value is written last on the output file. 
Ascending character keys are sorted according to 



Sign and 


Input 


Output 


Digit 


Punch 


Representation 


+9 


12-9 


I 


+8 


12-8 


H 


+7 


12-7 


G 


+6 


12-6 


F 


+5 


12-5 


E 


+4 


12-4 


D 


+3 


12-3 


C 


+2 


12-2 


B 


+1 


12-1 


A, 


+0 


12-0 


[t 


-0 


11-0 


]t 


-1 


11-1 


J 


-2 


11-2 


K 


-3 


11-3 


L 


-4 


11-4 


M 


-5 


11-5 


N 


-6 


11-6 





-7 


11-7 


P 


-8 


11-8 


Q 


•' 


11-9 


R 


'Valid on NOS with 029 keypunches. See 


appendix A, table A-2, for NOS/BE repre- 


sentations < 


Jf +0 and -0. 
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CONTROL STATEMENT SORTS OR MERGES 



This section describes Sort /Merge processing 
through control statement calls. The parameters 
that can appear in a S0RT5 or in a MERGE control 
statement are discussed, along with optional 
directive files. The CYBER Record Manager (CRM) 
requirements for control statement sorts or merges 
are explained. 



SORT5 CONTROL STATEMENT 

Sort/Merge sort capabilities are available through 
the S0RT5 control statement. Sort/Merge generates 
code based on the parameters you specify in the 
S0RT5 control statement (and directive files, if 
used) or on default values. Sort/Merge generates 
the code to make efficient use of memory, mass 
storage, and the central processor. 

The control statement begins with the word S0RT5, 
which must be followed by a period. The control 
statement can appear in one of the following forms: 



MERGE CONTROL STATEMENT 

Sort/Merge merge capabilities are available through 
the MERGE control statement. The input files for a 
merge must be presorted. Input files for a merge 
with summing must be presorted and presummed. When 
called with the MERGE control statement, Sort/Merge 
generates code based on the parameters you specify 
in the control statement (and directive files, if 
used) or on default values. Sort/Merge generates 
code to make efficient use of memory, mass storage, 
and the central processor. 

The control statement begins with the word MERGE, 
which must be followed by a period. The control 
statement can appear in one of the following forms: 



MERGE. pi, p2,, 



,pn 



SORT5.pl,p2... 



,pn 



MERGE.pl Ap2 A . . . A pn 

In the preceding control statement examples, p 
represents a processing parameter. Parameters must 
be separated by commas or spaces; commas and spaces 
can be used interchangeably. 



S0RT5.pl A p2 A ... Apn 



In the preceding control statement examples, p 
represents a processing parameter. Parameters must 
be separated by commas or spaces; commas and spaces 
can be used interchangeably. 

The S0RT5 control statement can be processed in a 
batch job or entered interactively from a ter- 
minal. The control statement must be CRM block 
type C (BT=C) and record type Z (RT=Z) format (see 
the CRM Basic Access Methods reference manual for 
information on block types and record types). Each 
line of the control statement can be up to 100 
characters in length; however, characters in excess 
of 80 are ignored. 

In interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 

In batch mode, you can continue a control statement 
on more than one line by terminating the line with 
two or more periods and beginning the new line with 
one period. 

NOTE 

Continuation is not allowed for ranges 
(indicated by two periods); ranges must be 
started and completed on the same line. 



You can continue a control statement on any number 
of lines up to a maximum of 240 characters; periods 
used as continuation symbols are not included in 
the character count . 



The MERGE control statement can be processed in a 
batch job or entered interactively from a ter- 
minal. The control statement must be CRM BT=C and 
RT=Z format. Each line of the control statement 
can be up to 100 characters in length; however, 
characters in excess of 80 are ignored. 

In interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 

In batch mode, you can continue a control statement 

on more than one line by terminating the line with 

two or more periods and beginning the new line with 

one period. You can continue a control statement 

on any number of lines up to a maximum of 240 char- 
acters; periods used as continuation symbols are 
not included in the character count. 



DIRECTIVE FILES 



A control statement sort or merge can use optional 
directive files that contain processing parameters 
in addition to the parameters in the S0RT5 or the 
MERGE control statement. Use of directive files 
allows specification of more complex sorts or 
merges (specifications that could be longer than 
allowed in a control statement) and permits stan- 
dardization of installation parameters and collat- 
ing sequences. 

You can specify multiple directive files for a 
single control statement sort or merge. All 
directive files must be CRM sequential files of 
block type C (BT=C) and record type Z (RT=Z) with 
record length (FL) of 100 characters or less; 
however, characters in excess of 80 are ignored. 
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In a directive file, each si ement ;i be up to 
240 chars, ters in U;ngth. Each -merit -rust 
; .'gin with the wot i ORT or with t \rord I 'GE 
followed immediately by a comma or space, and 
then followed by processing parameter.-, which are 
separated by commas or spaces. Tie following 
examples illustrate directive file foi ts: 

SORT, pi, p2 pa 

MERGE p!Ap2A...Apn 

You can continue a directive ixie statr-nent on more 
than one line by terminating the line with two or 
more periods. The new line must not begin with a 
period but can begin with one ur more ;paces. You 
specify directive files in the SOR 5 or MERGE 
control statement with the DIR paramet , discussed 
in the Sort/Merge Parameters subsection. 

SORT/ MERGE PARAMETERS 

You specify various parameters in the S0RT5 or the 
MERGE control statement, or in a direct. ve file, to 
direct Sort/Merge processing. Most parameters can 
appear either in a control statement or in a direc- 
tive file. The DIALOG parameter cannot appear in a 
directive file. Unless stated otherwise, a param- 
eter can appear only once in your sort or merge 
specification; a fatal error results if you specify 
duplicate parameters. You can specify parameters 
with keywords or by position in the control state- 
ment or directive file. When specified with 
keywords, parameters take one of the following 
forms, depending on the parameter: 

ke yword= ((value-set )[ , (value-set)] . .. ) 

keyword=value 

Spaces can appear anywhere in a parameter except 
within a name, a number, or a range indicator. The 
order for specifying parameters by position follows 
the descriptions of the individual parameters. 
Refer to section 7 for information on owncode 
routines, which are mentioned in the descriptions 
of several of the parameters. 



FROM 

The FROM parameter (figure 3-1) specifies the input 
files from which the records to be sorted or merged 
are read. As many as 100 files can be sorted or 
merged in one job step. The files are read in the 
order that you specify them; a file cannot be 
specified more than once for a merge. The files 
are read past end-of-record marks; reading termi- 
nates when end-of-file or end-of-inf ormation is 
encountered (see the CRM Basic Access Methods 
reference manual). The files are rewound before 
and after use unless the name of the file is INPUT 
or a FILE control statement parameter specifies 
otherwise. If a file is open when Sort/Merge is 
called, it is not rewound after use because the CF 
value in the FIT is undetermined. 

If you specify the file $NULL with the FROM param- 
eter, records to be sorted are not read from a file; 
records must be supplied by an ownc> , e routine. 
You can specify the FROM parameter more than once 
in a directive file. If you omit the FROM param- 
eter, records to be sorted are read from the file 



OLD (unless an owncode routine supplies records). 
An empty FROM file results in a null sort. The I 
FROM file cannot be the same as the TO file. | 



FROM=lfn 

FROM=(lfn1,lfn2, 

FROM=$NULL 



..) 



Ifn Logical file name; 1 to 7 letters or digits, 

beginning with a letter. 



Figure 3-1. FROM Parameter Format 



TO 



The TO parameter (figure 3-2) specifies the file to 
which sorted or merged records are written (unless I 
an owncode routine processes all records). The file | 
is not rewound before or after use unless a FILE 
control statement parameter specifies otherwise. 



TO=lfn 
















TO=$NULL 
















Ifn 


Logical 
beginni 


file name 
ng with a 


1 to 
letter. 


7 


letters 


or 


digits. 



Figure 3-2. TO Parameter Format 

If you specify the file $NULL with the TO param- 
eter, sorted or merged records are not written to a 
file; you must supply an owncode routine to process 
all records. If you omit the TO parameter, records 
are written to the file NEW (unless an owncode 
routine processes all records). The TO file cannot 
be the same as the FROM file. 



KEY 

The KEY parameter (figure 3-3) specifies the key 
fields that determine the sorted or merged order of 
output records. You can specify the KEY parameter 
more than once in a directive file on separate com- 
mand lines. A maximum of 100 key fields can be 
specified. 

Each key_def defines a separate key. They are 
defined in the order of precedence, from major key 
to minor key, read left to right. A key_def may 
consist of a range. A range consists of the first 
and last byte of the key, separated by two periods. 
A single integer may be considered as a special 
case of a range in which the first and last byte 
are the same. If a key_def consists of anything 
more than a range, it must be enclosed within 
parentheses, or else it will be processed as a 
multiple key sort. 

The key position and length are the first byte of 
the field and either the number of bytes or bits in 
the field (length of the field) or the last byte or 
bit of the field. You specify first and length (or 
last) as integers; the leftmost byte and the 
leftmost bit in a record are counted as number 1. 
For character data, each character is six bits and 
occupies one byte. For all types of data, first 
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KEY = 


~(key_def [,key_def] . ..)] 




range J 


key_def 


("range "1 

(range[,type[,ad] ] ) | 

L(first,length[,type[,ad] ] ) J 


range 


[first 1 
[first, .last J 


first 


First byte or bit of the key field. 


last 


Last byte or bit of the key field. 


length 


Number of bytes or bits in the key field; 
default is 1. 


type 


Name of a numeric data format or 
collating sequence; default is ASCII6. 


ad 


Order: A for ascending, D for descend- 
ing; default is ascending. 



Figure 3-3. KEY Parameter Format 

and length (or last) refer to bytes except for the 
formats BINARY_BITS and INTEGERJBITS. You must 
specify the first byte or bit of a key field. If 
you do not specify otherwise in the KEY parameter, 
the key length is assumed to be 1. 

The key type is the name of a predefined or 
user-defined collating sequence or the name of a 
numeric data format. If you do not specify a key 
type, the type is assumed to be the ASCII6 
collating sequence. See section 2 for a list of 
predefined collating sequences and numeric data 
formats. 

Sort order is either ascending or descending, and 
you specify A or D, respectively. If you specify 
neither, the sort order is assumed to be 
ascending. For numeric keys sorted in ascending 
order, the record having the key with the highest 
value is written last on the output file. 
Ascending character keys are sorted according to 
the collating sequence you specify. For numeric 
keys sorted in descending order, the record having 
the key with the lowest value is written last on 
the output file. Descending character keys are 
sorted in reverse order of the collating sequence 
you specify. 

Records are first sorted according to the key field 
described by the leftmost key_def. Records with 
equal values for the major key field are sorted 
according to the field described by the next 
key_def, and so on. A fatal error occurs if key 
fields overlap one another and the SEQA parameter 
is specified. A fatal error also occurs if the 
total number of key characters is more than 255. 
(If you also specify sum fields, the total number 
of characters in the key and sum fields together 
must be less than 256.) 

You must be careful when defining a sort with a 
single key. The following command defines a single 
key that is 20 bytes long, starting in byte 6: 

S0RT5. KEY=6..25 



The following command defines the same sort key: 

S0RT5. KEY=((6,20)) 

The following command defines a sort on two single 
byte keys where byte 6 is the major key and byte 20 
is the minor key: 

S0RT5. KEY=(6,20) 

If you omit the KEY parameter, the following 
assumptions are made: KEY=1.. (minimum record 
length) , the record length is the smallest MNR in 
the FILE control statements for input files (or the 
smallest FL for F and Z records), the key type is 
the ASCII6 collating sequence, and the sort order 
is ascending. 



DIR 

The DIR parameter (figure 3-4) specifies a direc- 
tive file or files from which sort or merge param- 
eters are read. Parameters in a directive file are 
read only after all of the control statement param- 
eters have been read. The files are read in the 
order that you specify them. The files are rewound 
before and after use unless the name of the file is 
INPUT or a FILE control statement parameter speci- 
fies otherwise. 



DIR = 


=lfn 














DIR= 


=(lfn1,lfn2, . . . ) 












Ifn 




Logical file name 
beginning with a 


1 to 
letter. 


7 


letters 


or 


digits. 



Figure 3-4. DIR Parameter Format 

You can specify the DIR parameter more than once in 
a directive file. If you omit the DIR parameter, 
no parameters are read from a directive file; the 
sort or merge is completely specified in the S0RT5 
or the MERGE control statement. 



The L parameter (figure 3-5) specifies the file to 
which listing information is written. The listing 
file is written in CRM BT=C, RT=Z format with a 
default full length of 132. Listing information 
includes the Sort/Merge version number, directive 
file statements, the time and date, and diagnostic 
messages, if any. 



L=lfn 




L=$NULL 




Ifn 


Logical file name; 1 to 7 letters or digits, 
beginning with a letter. 



Figure 3-5. L Parameter Format 
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The listing file is not rewound before or after use 
unless a FILE control statement parameter specifies 
rewind. If you specify the file $NULL with the L 
parameter, listing information is not written. If 
you omit the L parameter, listing information is 
written to the file OUTPUT. 



other parameters (except the STATUS parameter) 
specified in a control statement along with the 
DIALOG parameter do not affect sort or merge proc- 
essing; the sort or merge is performed solely on 
the basis of your dialog responses. Interactive 
use of the dialog is described in section 4, and 
the text of the dialog is included in appendix E. 



The E parameter (figure 3-6) specifies the file to 
which diagnostic, messages are written. The error 
file is written in CRM BT=C, RT=Z, and FL=72 
format. The file is not rewound before or after 
use unless a FILE control statement parameter 
specifies to rewind. 



E=lfn 

E=$NULL 

Ifn 



Logical file name; 1 to 7 letters or digits, 
beginning with a letter. 



Figure 3-6. E Parameter Format 

If you specify a listing file with a file name 
different from the error file name, diagnostic 
messages are written to the listing file and to the 
error file. If you specify the file $NULL with the 
E parameter, diagnostic messages are not written. 
If you omit the E parameter, diagnostic messages 
are written to the listing file. 



EL 

The EL parameter (figure 3-7) specifies "the error 
level to be reported. If EL=T, all trivial errors, 
plus all errors of levels W, F, and C, are reported. 
If EL=W, all warning errors, plus all errors of 
levels F and C, are reported. If EL=F, all fatal 
errors, plus all errors of level C, are reported. 
If EL=C, all catastrophic errors are reported. 
Omitting the EL parameter is equivalent to EL=W. 




Figure 3-7. EL Parameter Format 

Errors are written to the error file or, if no 
error file is specified, to the listing file. See 
appendix B for an explanation of the four levels of 
errors. 



DIALOG 

The DIALOG parameter (figure 3-8) invokes an inter- 
active dialog between you and Sort/Merge. The 
DIALOG parameter can appear only in a control 
statement. If DIALOG=YES, the dialog is invoked; 
if DIALOG=NO, the dialog is not invoked. Omitting 
the DIALOG parameter is equivalent to DIALOG=NO. 
The DIALOG parameter can be abbreviated as DIA, and 
Y or N can be specified instead of YES or NO. Any 
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DIALOG=YES (or DIA=Y) 
DIALOG=NO (or DIA=N) 



Figure 3-8. DIALOG Parameter Format 



NOTE 



Before entering a S0RT5 or MERGE command 
with the DIALOG parameter, ensure that 
your terminal is in normal mode by enter- 
ing the NORMAL terminal command. If your 
terminal is in ASCII mode during the 
interactive dialogue, Sort/Merge cannot 
recognize your responses unless you enter 
them using uppercase letters only. 

If you are already in the dialog, and need 
to change the terminal mode, enter a 
control-T to return to the system. 



ENR 

The ENR parameter (figure 3-9) specifies the esti- 
mated number of records to be sorted or merged. 
You specify either a single value or a range of 
values, and decimal integers (from through 
1000000000) or the CYBER Control Language (CCL) 
variables Rl, R2, R3, RIG, EF, or EFG. If ENR is 
specified as less than 1500, Sort/Merge uses less 
memory for the initial sort phase. This causes 
noticeably less memory required for the entire sort 
if the actual number of records is a low number. 



ENR=expr 

ENR=expr . . expr 

expr Expression that is a decimal integer, or CCL 

variable R1,R2,R3,R1G,EF, or EFG. 



Figure 3-9. ENR Parameter Format 



OWNF 



The OWNF parameter (figure 3-10) specifies the file 
that is the source of owncode routines; the file, 
which must contain relocatable object modules, is 
loaded by Sort/Merge by means of the user call 
loader. The load map from loading the routines is 
written to file ZZZZZLM. 



OWNF=lfn 

Ifn Logical file name; 1 to 7 letters or digits, 

beginning with a letter. 



Figure 3-10. OWNF Parameter Format 
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OWNFL 

The OWNFL parameter (figure 3-11) specifies the 
exact number of characters in any record from an 
owncode routine. The integer you specify can be 
from 1 to 5000. The OWNFL parameter can be 
abbreviated as OFL. See the discussion of the 
OWNMRL parameter for default values. 



OWNFL=integer 
OFL=integer 



Figure 3-11. OWNFL Parameter Format 



OWNMRL 

The OWNMRL parameter (figure 3-12) specifies the 
maximum length in characters of any record from an 
owncode routine. The integer you specify can be 
from 1 to 5000. The OWNMRL parameter can be 
abbreviated as OMRL. You do not need to specify 
the OWNMRL parameter if the sort or merge has an 
input or output file with a maximum record length 
at least as long as the longest record supplied by 
an owncode routine. 



OWNMRL=integer 

OMRU integer 



Figure 3-12. OWNMRL Parameter Format 

If you omit both the OWNMRL and the OWNFL param- 
eters, the record length specification of records 
from an owncode routine depends on the length 
specifications of the input and output files. If 
all input and output files have fixed length 
records of the same length, this length is used as 
a default OWNFL value; otherwise, the largest MRL 
or FL from any input or output file is used as a 
default OWNMRL value. 



If the sort has no input or output files (records 
to be sorted are supplied by an owncode routine and 
sorted records are processed by an owncode rou- 
tine), you must specify either OWNFL or OWNMRL; 
otherwise, a fatal error results. You cannot 
specify both the OWNFL and OWNMRL parameters for 
the same sort. Use of OWNFL rather than OWNMRL can 
increase performance. 



OWNn 

The OWNn parameter (figure 3-13) specifies the name 
of an owncode routine that is executed each time 
point n is reached during the sort or merge; n must 
be 1, 2, 3, 4, or 5. Owncode routines named by the 
OWNn parameter must be in the 0WNF file. All 
owncode routines are loaded before the sort or 
merge is started. If you omit the OWNn parameter, 
no owncode routine is executed. 



OWNn=proc 

n 1, 2, 3, 4, or 5 

proc Procedure-name; 1 to 31 letters, digits or 

the special characters ? # @ _. Only 7 
characters are significant and the first must 
be a letter. 



Figure 3-13. OWNn Parameter Format 



RETAIN 

The RETAIN parameter (figure 3-14) directs Sort/ 
Merge to output records with equal sort keys in the 
same order as the records are input ( RETAIN=YE S ) . 
If RETAIN=N0, or if you omit the RETAIN parameter, 
records with equal sort keys might not be output in 
the same order as they are input. If RETAIN=YES 
and you specify more than one sort or merge input 
file with the FROM parameter, the order in which 
you specify the files is the order in which records 
with equal keys are output. The RETAIN parameter 
can be abbreviated as RET, and Y or N can be speci- 
fied instead of YES or NO. 



RETAIN=YES (or RET=Y) 
RETAIN=NO (or RET=N) 



Figure 3-14. RETAIN Parameter Format 

You cannot specify both the RETAIN and the SUM 
parameters in the same sort or merge. If you do 
specify both, a catastrophic error occurs. 



SEQx 

The SEQx parameters (figure 3-15) define your own 
collating sequence. The SEQN parameter signals the 
start of your collating sequence definition and 
names the sequence; name is used as the key type in 
the KEY parameter when records are sorted according 
to your collating sequence. Specifying a name that 
is the same as the name of one of the predefined 
collating sequences results in a fatal error. 



SEQN=name 
SEQS=('char', 



'char') 



[SEQR=YES or SEQR=Y] 
[SEQA=YES or SEOA=Y] 



char 



Collating sequence name; 1 to 31 letters, 

digits, or the special characters ? # @ 

Only 10 characters are significant and the 
first must be a letter. 

Character in the collating sequence. 



Figure 3-15. SEQx Parameter Formats 
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Collating positions are assigned to the characters 
in your collating sequence by SEQS parameters; each 
SEQS parameter specifies either a single value step 
or a range of value steps in the sequence. A value 
step consists Of one or more characters, and 
characters specified in the same value step collate 
equally. The first SEQS parameter specifies the 
first value step or range of steps, the second SEQS 
parameter specifies the second value step or range 
of steps, and so on until your collating sequence 
is completely defined. The following paragraphs 
describe how to specify steps in your collating 
sequence with SEQS parameters. 



You can specify a single value step consisting of a 
single character by a graphic character (see 
appendix A) enclosed in apostrophes as in the 
following example: 



SEQS='A' 



You can also specify a single value step consisting 
of a single character by $CHAR(n) where n is the 
number of the character in the character set at 
your site (see table 3-1). The following example 
specifies a step consisting of the character number 
08 in the character set, which is the letter H: 



SEQS=$CHAR(08) 

You can specify a single value step consisting of 
several characters by a single character enclosed 
in apostrophes, followed by one or more characters 
and/or ranges of characters. The characters are 
enclosed in apostrophes. All characters specified 
or implied in such a step collate equally. The 
following example specifies a step consisting of 
the blank and the digits 0, 1, 2, and 3, all of 
which collate equally: 

SEQS=(' VOVl','2','3') 

The following example specifies the same value step 
as a range of characters where '0'..'3' specifies 
the range of digits from through 3: 

SEQS=(' ','0'. .'3') 

You can specify several value steps, each consist- 
ing of one character, with one value that is a 
range of characters. The characters are enclosed 
in apostrophes. The following example specifies a 
four-step collating sequence consisting of the 
digits 0, 1, 2, and 3, with assigned the lowest 
collating value: 

SEQS=('0'..'3') 



TABLE 3-1. $CHAR(n) CHARACTER NUMBERS 



Character 


CDC Graphic 


ASCII Graphic 


Octal 

6-Bit 

Display 

Code 


Character 


CDC Graphic 


ASCII Graphic 


Octal 
6-Bit 


Number 
(decimal) 


(64-Charac- 
ter Set)t 


(64 Charac- 
ter Set)t 


Number 
(decimal) 


(64-Charac- 
ter Set)t 


(64 Charac- 
ter Set )t 


Display 
Code 


00 






00 


32 


5 


5 


40 


01 


A 


A 


01 


33 


6 


6 


41 


02 


B 


B 


02 


34 


7 


7 


42 


03 


C 


C 


03 


35 


8 


8 


43 


04 


D 


D 


04 


36 


9 


9 


44 


05 


E 


E 


05 


37 


+ 


+ 


45 


06 


F 


F 


06 


38 


- 


- 


46 


07 


G 


G 


07 


39 


* 


* 


47 


08 


H 


H 


10 


40 


/ 


/ 


50 


09 


I 


I 


11 


41 


( 


( 


51 


10 


J 


J 


12 


42 


) 


) 


52 


11 


K 


K 


13 


43 


$ 


$ 


53 


12 


L 


L 


14 


44 


= 


= 


54 


13 


M 


M 


15 


45 


blank 


blank 


55 


14 


N 


N 


16 


46 


> 


9 


56 


15 








17 


47 


. 


. 


57 


16 


P 


P 


20 


48 


~ 


# 


60 


17 


Q 


Q 


21 


49 


I 


[ 


61 


18 


R 


R 


22 


50 


] 


] 


62 


19 


S 


S 


23 


51 


% 


% 


63 


20 


T 


T 


24 


52 


= 


Tl 


64 


21 


U 


U 


25 


53 


r 




65 


22 


V 


V 


26 


54 


V 


T 


66 


23 


W 


w 


27 


55 


A 


& 


67 


24 


X 


X 


30 


56 


t 


/ 


70 


25 


Y 


Y 


31 


57 


1 


•> 


71 


26 


Z 


Z 


32 


58 


< 


< 


72 


27 








33 


59 


> 


> 


73 


28 


1 


1 


34 


60 


< 


@ 


74 


29 


2 


2 


35 


61 


> 


\ 


75 


30 


3 


3 


36 


62 


— , 


* 


76 


31 


4 


4 


37 


63 


! 


t 


77 


'For 63-cha 


racter set dlff 


jrences , see the 


subsection e 


ntitled Chara 


cter Set Anomal 


ies in appendix A 




1_C 
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The preceding example is the same as specifying the 
following: 

SEQS='0' 
SEQS-'l' 
SEQS='2' 
SEQS='3' 

You can specify several value steps, each of which 
consists of more than one character, as ranges of 
characters where each range has the same number of 
characters. One value step in the collating 
sequence results for each character implied by the 
range. The characters are enclosed in apostro- 
phes. A diagnostic message is issued if each range 
does not consist of the same number of characters. 
The following example specifies a three-step 
collating sequence where the first step consists of 
1 and A (which are assigned the lowest collating 
value); the second step is 2 and B; the third step 
is 3 and C: 

SEQS=('1'..'3','A'..'C') 

The preceding example is the same as specifying the 
following: 

SEQS=('1','A') 
SEQS=('2','B') 
SEQS=('3','C) 

Any SEQS parameter that specifies a range of 
characters followed by a single character results 
in a fatal error. An apostrophe is specified in a 
SEQS parameter by four apostrophes (""). You can 
specify the SEQS parameter more than once in a 
directive file. SEQS parameter use is su mma rized 
in table 3-2. 

You can use one SEQR parameter to define a special 
value step that consists of all characters not 
explicitly or implicitly specified with SEQS param- 
eters; either YES or Y is allowed. The following 
example defines a sequence in which the digits 
collate in numeric order, then all special char- 
acters (such as periods, commas, slashes) collate 
equally, and then letters collate in alphabetic 
order: 



SEQS=('0'..'9') 

SEQR=YES 

SEQS=('A'..'Z') 

You can specify one SEQA parameter to alter in 
output records characters in the same value step to 
the first character in the step; either YES or Y is 
allowed. The following example alters all aster- 
isks and ampersands to slashes: 



SEQS=(7' 
SEQA=YES 



'&') 



Your collating sequence specification is terminated 
by any parameter other than SEQS, SEQR, or SEQA. 
You can define as many as 100 collating sequences 
by specifying a separate series of SEQx parameters 
for each collating sequence. The name of each 
user-defined collating sequence in a sort or merge 
must be unique. If you omit the SEQx parameters, a 
nonstandard collating sequence is not defined. 



STATUS 

The STATUS parameter (figure 3-16) specifies that a 
CYBER Control Language (CCL) variable be set to a 
value representing the highest level of error that 
occurred during the sort or merge. The CCL vari- 
ables Rl, R2, R3, RIG, EF, or EFG can be used for 
this purpose. Table 3-3 shows values that can be 
returned in the specified variable. For example, 
if you specify STATUS=R1 and Rl subsequently 
contains 20, a trivial error occurred. 



STATUS=variable (or ST=variable) 

variable CCL variable R1, R2, R3, R1G, EF, or EFG. 



Figure 3-16. STATUS Parameter Format 

If you include the STATUS parameter in your sort or 
merge specification, Sort/Merge does not abort if a 
catastrophic error occurs before any data records 
are input. However, if Sort/Merge calls another 



TABLE 3-2. SEQS PARAMETER SUMMARY 



Number of Value 
Steps Specified by 


Number of Characters 
in Each Value Step 


How Specified 


Example 




One SEQS Parameter 








1 step 


1 character 


Graphic character or $CHAR(n) 
where n is the number of the char- 
acter in your character set. 


SEQS='H' or 
SEQS=$CHAR(08) 




1 step 


More than one 


Each character in the step is 


SEQS=('I','0','X') or 






character 


enclosed in apostrophes and sepa- 
rated by commas, or a single char- 
acter is followed by one or more 
ranges of characters . 


SEQS=(':','0'..'9') 




More than one step 


1 character 


One range of characters. 


SEQS=('0'..'9') 




More than one step 


More than one 
character 


Ranges of characters where each 
range has the same number of char- 
acters. 


SEQS=('A'..'E','V'..'Z 


) 
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TABLE 3-3. ERROR LEVEL CODES, STATUS PARAMETER 



Error Level 



No errors 

Trivial 

Warning 

Fatal 

Catastrophic 



Code 




20 
30 
40 
50 



product and an unrecoverable error results, an 
abnormal job termination will occur. For example, 
if Sort/Merge called a product, such as Common 
Memory Manager (CMM), and CMM processing results in 
an error, a termination will occur. If you omit 
the STATUS parameter, no error status variable is 
set, and Sort/Merge aborts if a catastrophic error 
occurs. The STATUS parameter can be abbreviated as 
ST. 



SUM 

The SUM parameter (figure 3-17) specifies the 
fields that are to be summed in records with equal 
key values. Input files for a merge with summing 
must be presorted and presummed. As many as 255 
bytes can be summed. The records with all key 
fields equal are combined into one new record, and 
the other records with equal keys are deleted. The 
one resultant record contains the key fields and 
the fields that are the sums of the specified 
fields from all the records with equal keys; a data 
field that is not a key field or a sum field is set 
to the corresponding field from one of the old 
records. 



SUM = ((sum_def)[,{sum_def)] . . . ) 


sum_def 


("(first,length[,type[,rep] ] )"| 
L (range[,type[,rep]]) J 


range 


[first 1 
[first., last J 


first 


First byte or bit of the sum field. 


last 


Last byte or bit of the sum field. 


length 


Number of bytes or bits in the sum field; 
default is 1. 


type 


Name of a numeric data format (except 
REAL); default is INTEGER. 


rep 


Number of fields to be summed; default 
is 1. 



Figure 3-17. SUM Parameter Format 



All the fields to be summed must contain numeric 
data; otherwise, the contents of the new fields are 
undefined. The fields described as sum fields 
cannot also be key fields. 



In figure 3-17, a sum_def describes a field to be | 
summed by specifying the field length and position, 
a numeric data format, and the number of fields to 
be summed. The field length and position are the 
first byte or bit of the field, and either the 
number of bytes or bits in the field (length of the 
field), or the last byte or bit of the field. You 
specify first and length (or last) as integers; the 
leftmost byte and the leftmost bit in a record are 
counted as number 1. First and length (or last) 
refer to bytes except for formats BINARY_BITS and 
INTEGER_BITS. You must specify the J^irst byte or 
bit of the sum field. If you do not specify other- 
wise in the SUM parameter, the sum length is 
assumed to be 1; sum length can be a maximum of 17 I 
bytes. I 

Sum field type is the name of a numeric data format 
except REAL; fields containing data in REAL format 
cannot be summed. You must specify the sum field 
type; no default exists. See section 2 for a ]ist 
of numeric data formats. The number of fields to 
be summed is specified as an integer; the default 
is 1. If you specify multiple fields with one SUM 
parameter, the fields must be consecutive, must be 
the same length, and must contain the same type of 
numeric data. Sum fields cannot overlap one 
another. If a sum field contains no data because a 
record is short, the sum for that field is unde- 
fined. If you do not specify a sum type, the type 
is assumed to be INTEGER. 



Figure 3-18 shows an example of a SUM parameter. 
Part A of figure 3-18 shows the layout of the 
record containing the fields to be summed. Part B 
shows three SUM parameters, each describing one 
field to be summed. Part C shows one equivalent 
SUM parameter that describes the three consecutive 
fields to be summed. Note that when you specify a 
single value-set, two sets of parentheses are still 
required. 



If the summing of the specified fields results in 
new numeric values that do not fit into the sum 
fields, a fatal error results. One of the records 
that caused the overflow is deleted as usual, but 
the sum field contents in the remaining record are 
undefined. A diagnostic message indicating which 
field caused the overflow is issued, and the job 
step is terminated at the end of the sort (unless 
you include the STATUS parameter). 



You can specify the SUM parameter more than once in 
a directive file. If you omit the SUM parameter, 
records with equal key values are not automatically 
combined into single records. You cannot specify 
both the SUM parameter and an owncode 5 routine for 
the same sort or merge. You cannot specify both 
the RETAIN parameter and the SUM parameter in the 
same sort or merge. If you do specify both, a 
catastrophic error occurs. 
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A. Record Layout 

1 10 15 20 25 




Student number 
(sort key) 


Number of 
units registered 


Number of 
units completed 


Grade points 




B. SUM Parameters 

SUM=((11,5,INTEGER)) 
SUM=((16,5,INTEGER)) 
SUM=((21,5,INTEGER)) 

C. SUM Parameter 

SUM=((11,5,INTEGER,3)> 



Figure 3-18. SUM Parameter Example 



VERIFY 

The VERIFY parameter (figure 3-19) directs Sort/ 
Merge to check merge input records for correct 
order. This parameter applies only if you are 
performing a merge. If a merge input record is out 
of order when you have specified VERIFY=YES, the 
merge is terminated (regardless of the STATUS 
parameter) and a diagnostic message is issued. If 
VERIFY=N0, merge input records are not checked for 
correct order. Omitting the VERIFY parameter is 
equivalent to VERIFY=N0. You can specify VER 
instead of VERIFY, and Y or N instead of YES or 
NO. The VERIFY parameter is ignored if you are 
performing a sort. 



FASTIO YES 
FASTICNNO 



(or FASTIO=Y) 
(or FASTIO=N) 



Figure 3-20. FASTIO Parameter Format 

If FASTIO=YES, all sort input and output files with 
block type C and record type F, or block type I and 
record type W, are read directly by Sort/Merge. If 
FASTI0=N0, all sort input and output files are 
processed using CRM. Omitting the FASTIO parameter 
is equivalent to FASTI0=N0. You can specify Y or N 
instead of YES or NO. 



VERIFY=YES 
VERIFY=NO 



(or VER=Y) 
(or VER=N) 



Figure 3-19. VERIFY Parameter Format 



FASTIO 



The FASTIO parameter (figure 3-20) specifies that 
certain sort input and output records are to be 
read and written directly by Sort/Merge rather than 
by means of CYBER Record Manager (CRM). The FASTIO 
parameter is ignored during a merge. Files 
processed by the FASTIO parameter must reside on 
mass storage. The records in these files must be 
block type C and record type F, or block type I and 
record type W (see the CRM Basic Access Methods 
reference manual for detailed information). All 
input files must have identical record types and 
record lengths. If the file resides on tape, or if 
the records are not all the same type and length, a 
warning diagnostic is issued and the FASTIO option 
is canceled. The files are then processed using 
CRM. Sort/Merge obtains block and record type 
information from the file information table (FIT); 
a FILE control statement is not ignored. 
Specifying the FASTIO parameter results in 
increased speed, but not all errors are diagnosed; 
use this parameter when you are sure your files are 
correctly written and described. 



SPECIFYING PARAMETERS 
BY POSITION 

You can specify any of the Sort/Merge parameters in 
a control statement or in a directive file without 
a keyword by supplying a value in the position 
assigned to that particular keyword^ Table 3-4 
lists the parameter keywords and the position 
assigned to each. Omitted parameters are replaced 
by commas. For example, the following control 
statements are equivalent: 

SORT5.INFL,OUTFL,5. .9, , ,,F 

S0RT5. FR0M=INFL , T0=0UTFL, KEY=5. . 9 , EL=F 

The two preceding control statements specify that 
records to be sorted are in the file INFL, and 
sorted records are to be written to file OUTFL. 
The sort key field begins with the fifth character 
of each record, and the last character of the key 
field is the ninth character of the record. Fatal 
and catastrophic errors are to be reported. 

You can mix keyword specification and positional- 
specification of parameters in the same control 
statement or directive file. Whenever you specify 
a parameter with a keyword, the parameter retains 
its position number (table 3-4). Any positional 
parameters you specify after a keyword parameter 
are numbered according to the position number of 
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TABLE 3-4. PARAMETER POSITIONAL ORDER 



Parameter 
Keyword 



FROM 
TO 
KEY 
DIR 

L 

Reserved for 
future use 

E 

EL 

DIALOG 

ENR 

Reserved for 
future use 

Reserved for 
future use 

OHNF 

OWNFL 

OWNMRL 

Reserved for 
future use 

0WN1 

OWN2 

OWN3 

0WN4 

0WN5 

RETAIN 

SEQA 

SEQN 

SEQR 

SEQS 

STATUS 

SUM 

Reserved for 
future use 

VERIFY 

FASTIO 



Position 
Number 



10 
11 

12 

13 
14 
15 
16 

17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 

30 
31 



the last keyword parameter you specified. The 
following example illustrates mixing keyword and 
positional parameters: 

S0RT5.DIR=DIRFIL, , , , , ,6000,RET=Y, , , , ,EFG 

The DIR parameter is position number 4. Commas 
replace parameters 5 through 9. The estimated 
number of records (6000) is position number 10. 
Numbering begins again with a keyword parameter 
(RETAIN number 22). Commas replace parameters 23 
through 26. The positional value EFG is the status 
variable (STATUS number 27). 



FILE CONTROL STATEMENT 

Unless default characteristics apply for a file, 
you must specif y the r characteristics of all input 
and output data files named in a S0RT5 or a MERGE 
control statement, or in a directive file, with a 
CYBER Record Manager (CRM) FILE control statement. 
FILE control statements must precede the S0RT5 or 
the MERGE control statement. The format of the 
FILE control statement is shown in figure 3-21. 



FILE(lfn[,keyword=option] . . . ) 



Ifn Logical file name; 1 to 7 letters or 

digits, beginning with a letter. 

keyword=option Symbolic name of the file information 
table (FIT) field and the option 
selected. 



Figure 3-21. FILE Control Statement Format 

The file information table (FIT) is a table through 
which file characteristics are communicated to CRM 
Basic Access Methods; the FIT contains information 
that describes the file and specifies how the file 
is accessed. You set FIT fields by specifying the 
symbolic name of the field in the FILE control 
statement and selecting one of the options associ- 
ated with that field. Several FIT fields important 
to Sort/Merge processing are discussed in the 
following paragraphs. The CRM Basic Access Methods 
reference manual contains a complete list of all 
FIT fields and options that you can select. Note 
that specification of certain FIT fields can 
require setting of additional FIT fields. 

Input files to be sorted or merged, and output 
files to which sorted or merged records are writ- 
ten, must be sequential files (records are read and 
written in order one after the other). The file 
organization (FO) FIT field can be included in the 
FILE control statement and sequential organization 
specified (F0=SQ); you can omit this parameter and 
sequential organization is assumed. 

Sequential files are organized into groups of 
records called blocks. Block type is specified 
with the block type (BT) FIT field. The default is 
BT=C. CRM also offers several record types, and 
any of these record types except U can be sorted or 
merged. Record type is specified with the record 
type (RT) FIT field. The default is RT=Z. The 
full length (FL) or maximum record length (MRL) FIT 
field must be set to establish the number of char- 
acters in a record. The default is FL=150 or 
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MRL=150. The default is also a satisfactory 
description for records of less than 150 char- 
acters. If you have any files of considerably less 
than 150 characters (25 characters for example) , 
Sort/Merge can perform more efficiently if you 
include a FILE control statement. 



taneously open. The default file buffer size (BFS) 
is 20018 words. You can change this value with 
FILE control statement to save memory. 



TABLE 3-5. FILE CHARACTERISTICS 



Default CRM characteristics apply for the files 
INPUT, OUTPUT, and PUNCH. You do not need to 
include FILE control statements for these files. 



Table 3-5 summarizes the default file characteris- 
tics for Sort/Merge input and output data files, 
directive files, the error and listing files, and 
the files INPUT, OUTPUT, and PUNCH. 



SPECIFYING MAXIMUM 
RECORD LENGTH 

Unless default characteristics apply for a file, 
Sort/Merge requires that you specify maximum record 
length for input and output data files. You 
specify maximum record length by setting the FL or 
MRL FIT field in the FILE control statement. Set 
the FL FIT field for F or Z type records to specify 
the length of each record (if RT=F), or the upper 
limit of characters in a record (if RT=Z). For all 
other record types, set the MRL FIT field to 
specify the maximum length of a record. 



x.. FIT 








\. Field 


BT 


RT 


FL 


File \. 








FROM files 


C 


Z 


FL<150 


TO file 


C 


Z 


FL<150 


DIR files 


C 


Z 


FL<100 


L file 


C 


Z 


FL=132 


E file 


c 


Z 


FL=72^ 


INPUT 


c 


Z 


FL=80 


OUTPUT 


c 


Z 


FL=140 


PUNCH 


c 


Z 


FL=80 


'If E=0UTPUT, FL=140 is used. 



FIELD LENGTH REQUIREMENTS 

Large sort or merge operations can require 
additional central memory. The memory needed for a 
merge is directly proportional to the number of the 
input files you have, because all files are simul- 



LISTINGS 



If an error occurs during the sort or merge, the 
message S0RT5 - USER ERROR, JOB ABORTED is sent to 
your job dayfile. Otherwise, when the sort or 
merge is complete, a message indicating the number 
of records sorted or merged is sent to the dayfile. 
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INTERACTIVE USE 



Sort/Merge capabilities are available interac- 
tively; you can specify any of the Sort/Merge 
parameters from your terminal. Sort/Merge also 
provides a tutorial dialog to aid in specifying 
parameters. This section describes the use of this 
dialog, Sort/Merge interactive commands, and login 
and logout processes. The complete text of the 
dialog is included in appendix E. 



In interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 



PASSWORD: 

Enter the 4- to 7-character password 
assigned to you to provide access security; 
some terminals overtype to preserve privacy. 

termnam- APPLICATION : 

Enter IAF (for Interactive Facility, the 
network software that provides you with the 
time-sharing capabilities of NOS); termnam 
represents the terminal identification. 

JSN: zzzz, NAMIAF 
CHARGE NUMBER: 



TERMINAL ACCESS TO 
SORT/ MERGE 



To access Sort/Merge from your terminal, you first 
establish the physical connection between the 
terminal and the computer. The method of estab- 
lishing the connection varies depending on the type 
of terminal and the coupling between the terminal 
and computer. Consult the NOS Version 2 Reference 
Set, Volume 1 (for NOS users) or the INTERCOM 
reference manual (for NOS/BE users) for information 
on connection methods. 



Connecting your terminal to the computer initiates 
the login process. The operating system, either 
NOS or NOS/BE, identifies itself to you, and you 
must supply information that indicates you are a 
valid system user. 



LOGGING IN UNDER NOS 

The login procedure to NOS begins with initial 
information from the system (including date, time, 
terminal name, installation name, and operating 
system version). The second line of this informa- 
tion is dependent on the installation. You are 
then prompted to enter information to indicate you 
are a valid system user. The prompts and required 
responses are as follows: 

FAMILY : 



JSN: zzzz, NAMIAF 
READY. 

If a charge number is requested, enter your 
assigned charge number and project number. 
The system will then respond with READY. 
The login procedure is now complete. You 
can then enter the batch subsystem. Do not 
change to ASCII mode since Sort/Merge does 
not process data in this mode. 

Figure 4-1 shows an example of a NOS login. You 
are now ready to perform sort or merge operations 
as described later in this section. 



82/01/08. 10.42.16. T143A 

CDC NOS 2 

FAMILY: 

USER NAME: xxxxxxx 

PASSWORD: xxxx 

T143A - APPLICATION: iaf 

JSN: AADI, NAMIAF 

CHARGE NUMBER: 
? SX«55®CX10f 

PROJECT NUMBER: 

? mmmmmxmm 

READY. 

/batch 
RFL,0. 

/ 



Figure 4-1. NOS Login Example 



Enter the family name of the mass storage 
device that contains your permanent files. 
Some installations do not request a family 
name; the family name is the default family 
for the system. 



USER NAME: 



Enter the user name assigned to you by your 

system administrator. 



LOGGING IN UNDER NOS/BE 

As soon as your terminal is connected to the 
system, the system responds with a message indi- 
cating date, time, and the INTERCOM version number 
(INTERCOM is the software that directs the flow of 
data between your terminal and the central site 
computer). The system requests the following: 

PLEASE LOGIN 
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Enter LOGIN. You are then prompted for validation 
information. The prompts and required responses 
are as follows : 

ENTER USER NAME- 

Enter the user name assigned to you by your 
system administrator. 

oaSMXKKXXX ENTER PASSWORD- 

Enter the password (up to 10 letters and 
digits) assigned to you to provide access 
security; some terminals overtype to pre- 
serve privacy. 



When the user number and password are accepted, a 
2-character user code and the login time, followed 
by the equipment number and port number, are dis- 
played or printed at your terminal. The message 
COMMAND- appears, indicating the login process is 
complete. Figure 4-2 shows an example of' NOS/BE 
login. You are now ready to perform sort or merge 
operations as described in the following subsection. 



CONTROL DATA INTERCOM 5.0 
DATE 01/23/81 
TINE 09.35.50. 

PLEASE LOGIN 

Log in 

ENTER USER NAME-sort 

WNHBUHHOHf ENTER PASSW0RD- 



01/23/81 LOGGED IN AT 09.36.23. 
WITH USER-ID OK 
EQUIP/PORT 63/076 



LOGIN CREATED 01/21/81 TODAY is 01/23/81 
C0MMAND- 



Figure 4-2. NOS/BE Login Example 

INTERACTIVE DIALOG 

Sort/Merge provides an interactive dialog to aid in 
specifying parameters. The tutorial dialog is 
designed to guide you, step by step, through your 
sort or merge specification. You can specify any 
control statement sort or merge, including a sort 
or merge with owncode routines and a nonstandard 
collating sequence, using the interactive dialog. 

After login is complete, and before beginning the 
dialog, you must assign any files used in your sort 
or merge (files containing input records to be 
sorted, owncode routines, or presorted files to be 
merged) to your terminal with an ATTACH command or 
the equivalent. You must enter CYBER Record Man- 
ager (CRM) FILE control statements for any of your 
files that are not written in standard unit record 
format. Standard unit record format files include 
files created by punched cards in a batch job or 



lines entered at a terminal, and the special files 
INPUT, OUTPUT, and PUNCH. CRM defines these files 
as block type C (BT=C) and record type Z (RT=Z). 
Sort/Merge assumes each record contains 150 char- 
acters or less. If you have any files of consider- 
ably less than 150 characters (25 characters for 
example), Sort/Merge can perform more efficiently 
if you enter a FILE control statement. See your 
operating system reference manual for information 
about retrieving permanent files and the CRM Basic 
Access Methods reference manual for information 
about FILE control statements. 

For NOS/BE users, Sort/Merge automatically connects 
and disconnects files INPUT and OUTPUT; Sort/Merge 
writes the dialog to OUTPUT, which is displayed or 
printed at your terminal. Your dialog responses 
are read from INPUT. 

NOTE 

Before entering a S0RT5 or MERGE command 
with the DIALOG parameter, ensure that 
your terminal is in normal mode by enter- 
ing the NORMAL terminal command. If your 
terminal is in ASCII mode during the 
interactive dialogue, Sort/Merge cannot 
recognize your responses unless you enter 
them using uppercase letters only. 

If you are already in the dialog, and need 
to change the terminal mode, enter a 
control-T to return to the system. 



The interactive dialog begins when you type 
S0RT5.DIAL0G=YES or MERGE. DIALOG=YES. Any other 
parameters (except STATUS) that you enter along 
with DIALOG are ignored. During the dialog, Sort/ 
Merge asks various questions, one at a time, and 
your response to each question determines the next 
question. For example, Sort/Merge asks if you have 
just one input file and no 0WN1 or 0WN2 subrou- 
tines. If you enter YES, the next question requests 
the name of your input file. If you enter NO, the 
next question asks if you have an OWN1 subroutine. 

The expected response to each question is evident 
from the question. For example, one question asks 
how many key fields you have; you enter a number. 
For questions requiring yes or no answers, you can 
type YES or Y, or NO or N. If you make a mistake 
(misspell the word yes, for example), Sort/Merge 
gives you an explanation of the expected answer and 
asks the question again. If you enter an incorrect 
answer a second time, Sort/Merge asks you if you 
want help. If you type YES, an explanation of 
Sort/Merge usage is displayed or printed at your 
terminal. If you do not want help and type NO, the 
original question is repeated. Figure 4-3 shows an 
example of this sequence. 

The last question Sort/Merge asks is how many 
records are to be sorted or merged. After you 
enter the appropriate number, Sort/Merge informs 
you that the sort or merge you have specified is 
beginning. When the sort or merge is complete, 
control of your terminal is returned to the oper- 
ating system; the operating system prompt for input 
appears (/ under NOS, COMMAND- under NOS/BE). 
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/sort5.dialog=yes-« 

IS YOUR TERMINAL ALREADY SET TO NORMAL MODE OR UPPERCASE 
ASCIII MODE. ALSO, ARE YOU SURE THAT ALL YOUR FILES (IF ANY) 
ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE 
CONTROL STATEMENTS SPECIFIED FOR THEM 

? yes 
DO YOU HAVE JUST ONE INPUT FILE AND NO OWN1 OR OWN2 SUBROUTINES 

? no 
DO YOU HAVE AN OWN1 SUBROUTINE 

? yse-« — — 

DO YOU HAVE AN OWN1 SUBROUTINE ■* 

? yse -4 

DO YOU WANT HELP 

? y 

SINCE YOU DID NOT SAY "NO" YOU ARE GOING TO BE HELPED. -« ; — 

'Y' IS THE SAME AS 'YES' AND 'N' IS THE SAME AS 'NO'. 

TYPE 'RESTART' TO GO BACK TO THE BEGINNING. 

TYPE 'QUIT' TO STOP RUN. 

THE OWN1 ROUTINE CAN BE USED TO PROCESS INPUT RECORDS. 



Begin interactive dialog. 



Incorrect response. 
Question asked again. 
Second incorrect response. 



Help after second incorrect response. 



A DETAILED DESCRIPTION 
OF THIS OWNCODE ROUTINE IS IN THE SORT/MERGE REFERENCE MANUAL. 
DO YOU HAVE AN OWN1 SUBROUTINE-. : 



? yse 

DO YOU HAVE AN OUN1 SUBROUTINE 
? yse 

DO YOU WANT HELP 
? no 

DO YOU HAVE AN OWN1 SUBROUTINE ♦- 
? yes 



Question asked again. 



No help after second incorrect 
response; question asked again. 



Figure 4-3. Incorrect Response Example 



If sorted or merged records are written to a file 
(not processed by an owncode routine), Sort/Merge 
creates a local file and gives this file the name 
you entered in response to the question "What is 
the name of your output file?" Upon completion of 
the sort or merge, you can display or print this 
file at your terminal, or route the file to a 
printer to be listed. If you want to use the file 
at a later time, you must save it as a permanent 
file before logging out; otherwise, the file is 
lost. Figure 4-4 shows an example of output file 
disposition. 



After the explanation, the question Sort/Merge 
asked you immediately before you entered the HELP 
command is asked again, resuming the dialog. 



RESTART 

If you type RESTART, the interactive dialog is 
started over at the beginning. All previous 
answers to questions are discarded. You can use 
this command if you give Sort/Merge incorrect 
information such as the wrong number of key fields. 



INTERACTIVE COMMANDS 



QUIT 



Several commands exist to control the use of the 
interactive dialog. These commands are HELP, 
RESTART, and QUIT. A command can be entered at any 
time during the dialog, but HELP, RESTART, and QUIT 
cannot be the names of user-supplied entities such 
as files and collating sequences. Use of the 
commands is described in the following paragraphs. 



HELP 



If you type QUIT, the interactive dialog is ter- 
minated. The sort or merge is not performed, and 
control of your terminal is returned to the oper- 
ating system. You can then perform other terminal 
operations or logout. If permanent files con- 
taining input records to be sorted or merged, or 
owncode routines have been assigned to your job, 
you should release these files by using the RETURN 
command (see your operating system reference 
manual) . 



If you type HELP, an explanation of Sort/Merge 
usage is displayed or printed at your terminal. 



Figure 4-5 shows an example of interactive command 
use. 
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/sort5.dialog=yes 



WHAT IS THE NAME OF YOUR OUTPUT FILE 
? srtout -*— — 



THANK YOU SORT/MERGE NOW BEGINS.- 
SORTS. dialog=YES -■ — • — — 

/copysbf, srtout, output -* 

1REYES S L 1OO246031558ANTHRO 
MAYER M I 100991122359ANTHR0 
CHARLES S H 1 01 41 8032459ANTHR0 
MARTIN R C 100955032157ART 
NEECE n L 99911121358ART 



LASEUR P T 

SUGARMAN B T 

SMITH F R 

DOUGLAS M L 

OKADA N A 

EOI ENCOUNTERED, 
/rewind, srtout 
REWIND, SRTOUT. 
/copysbf, srtout, my fi I 

EOI ENCOUNTERED, 
/route, myf i L,dc=pr -*- 

ROUTE COMPLETE, 
/save, srtout -* 



100678042256PSYCH 

100528070457SOC 

101062120753SOC 

101325071558UNDEC 

100103111750UNDEC 



3341 
2882 
2453 
2891 
2291 



2233 

3501 
2913 
2585 
2225 



Begin interactive dialog. 



Local file created for sorted output. 



Dialog completion; sort begins. 

NOS repeats control statement (up to 48 characters). 

Display or print sorted file. 



File SRTOUT. 



Copy sorted file to be listed by printer. 
Route copy of sorted file to printer. 
Make sorted file a permanent file. 



Figure 4-4. Output File Disposition Example 



| 4-4 



60484800 D 



/sorts. dialog = yes^ Begin interactive dialog. 

IS YOUR TERMINAL ALREADY SET TO NORMAL MODE OR UPPERCASE 
ASCII MODE. ALSO, ARE YOU SURE THAT ALL YOUR FILES (IF ANY) 
ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE 
CONTROL STATEMENTS SPECIFIED FOR THEM 

? y 

YOU HAVE JUST ONE INPUT FILE AND NO OWN1 OR OWN2 SUBROUTINES 
? n 

DO YOU HAVE AN OWN1 SUBROUTINE 
? y 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S ) 
? myrthns 

WHAT IS THE NAME OF YOUR OWN1 SUBROUTINE 
? restarts __ Conmand entered. 

IN RESPONSE TO YOUR REQUEST RESTART HAS BEEN INITIATED. 

IS YOUR TERMINAL ALREADY SET TO NORMAL MODE OR UPPERCASE ) 

ASCII MODE. ALSO, ARE YOU SURE THAT ALL YOUR FILES (IF ANY) \ Dialog Started over 

ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE ( at beginning. 

CONTROL STATEMENTS SPECIFIED FOR THEM ' 

? y 

DO YOU HAVE JUST ONE INPUT FILE AND NO OWN1 OR OWN2 SUBROUTINES 
? n 

DO YOU HAVE AN OWN1 SUBROUTINE 

? y 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S ) 

? ownsrtn 
WHAT IS THE NAME OF YOUR OWN1 SUBROUTINE 

? myrtn 
DO YOU HAVE AN 0WN2 SUBROUTINE 

? help-* Command entered. 

'Y' IS THE SAME AS 'YES 1 AND 'N' IS THE SAME AS 'NO 1 . ^ 

TYPE 'RESTART' TO GO BACK TO THE BEGINNING. / 

TYPE 'QUIT' TO STOP RUN. > usa 9 e 

THE 0WN2 ROUTINE CAN BE USED TO PROCESS INPUT FILES. A DETAILED DESCRIPTION I ex P lanat1on - 

OF THIS OWNCODE ROUTINE IS IN THE SORT/MERGE REFERENCE MANUAL. / 

DO YOU HAVE AN OWN2 SUBROUTINE 

? quit-« _ —— Command entered. 

SORT/MERGE IS QUITTING.-* Sort/Merge terminated . 



Figure 4-5. Interactive Command Example 
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SPECIFYING PARAMETERS 
INTERACTIVELY 

You can specify any of the Sort/Merge parameters 
from your terminal in a S0RT5 or MERGE control 
statement. After you login, assign all necessary 
files (including directive files) to your job, and 
type in FILE control statements for files with 
other than default characteristics. You enter 
S0RT5 or MERGE followed by parameters in one of the 
following forms: 



S0RT5.pl,p2,. 



,P" 



MERGE. plA p2A ...Apn 

In the preceding example, p represents a processing 
parameter. Parameters must be separated by commas 



or spaces; commas and spaces can be used inter- 
changeably. You can enter the control statement 
and parameters in input line character positions 1 
through 80. If your sort or merge specification is 
longer than 80 characters, you must use a directive 
file for the additional parameters. 

Figure 4-6 shows an example of specifying param- 
eters interactively. 



LOGGING OUT 

To end your terminal session, you type GOODBYE, 
BYE, or LOGOUT if you are using the Interactive 
Facility of NOS. If you are using INTERCOM under 
NOS/BE, you type LOGOUT. Under either system, a 
message indicating that you are logged out is dis- 
played or printed at your terminal. 



/ attach, univer -"- 



/file(univer,bt=c,rt=z,fl=38)) 

FILE(UNIVER,BT=C,RT=Z,FL=38) (^. " 

If i le(oout,bt=c,rt=z,f 1=38) ( 

FILE<00UT,BT=C,RT=Z,FL=38) ' 

/sort5 . f rom=uni ver,to=oout,key=( (35,3,330116,00) 

SORT5.FROM=UNIVER,TO=0OUT,KEY=((35,3,ASCII6,D)) 

/ — . 



- Input file assigned to the job. 

• FILE control statements for input 
and output files because records 
are only 35 characters in length. 

> S0RT5 control statement entered. 

- NOS repeats control statement 
(up to 48 characters). 

• Control returns to NOS operating system. 



Figure 4-6. Interactive Parameter Specification Example 
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PROCEDURE CALLS 



Sort/Merge also exists as a set of procedures; a 
sort or merge can be invoked from within a program 
by a sequence of procedure calls. The procedures 
can be called from FORTRAN or by a program in any 
language that uses the standard FORTRAN calling 
sequence. The same type of Sort/Merge processing 
is available through the procedures as is available 
through the S0RT5 or the MERGE control statement; 
the procedure calls closely correspond to the 
Sort/Merge parameters. This section describes the 
procedure calls; COBOL programmers should see 
section 6 for information on calling the procedures. 

All conventions for coding FORTRAN statements must 
be observed in procedure calls (see the FORTRAN 5 
reference manual). You must assign any permanent 
files named in procedure calls to your job with an 
ATTACH command (or the equivalent) in the control 
statement section of the job. The procedures 
cannot be used in a static memory management 
environment . A merge could require twice as much 
mass storage for intermediate merge files as is 
required for the merge input files . 

All files to be sorted, or presorted files to be 
merged, must be sequential files. The default file 
characteristics are block type C, record type Z, 
and full length of 150 characters or less. For 
files with other block types and record types, you 
must include CYBER Record Manager (CRM) FILE 
control statements in the control statement section 
of your job . See the CRM Basic Access Methods 
reference manual for information on block types and 
record types . 

The procedures can be called in any order with two 
exceptions: SM5S0RT or SM5MERG must be the first 
procedure called, and SM5END must be the last 
procedure called. Sort/Merge collects processing 
information until SM5END is called; the sort or 
merge is then performed. Unless stated otherwise, 
a procedure can be called only once during a sort 
or merge. Refer to section 7 for information on 
owncode routines , which are mentioned in the 
descriptions of several of the procedures. 

SM5SORT 

Execution of the SM5S0RT procedure signals the 
beginning of a sort specification. The SM5S0RT 
procedure must be the first procedure called for a 
sort. The format of the SM5S0RT call is shown in 
figure 5-1. 



CALL SM5SORT(option) 

option Result array name (1 to 7 letters or digits, 

beginning with a letter) or the integer 0. 



statistics and results to your program when the 
sort is completed. You set the first element of 
the result array to the number of elements (as many 
as 15) in which you want to receive information. 
If you set the first element to or specify CALL 
SM5S0RT(0) , no statistics or results are returned. 
The type of result that is returned in each element 
is shown in table 5-1. 



TABLE 5-1. RESULT ARRAY FORMAT 



Figure 5-1. SM5SORT Format 

The array associated with the SM5S0RT procedure is 
a 16-element integer array that returns sort 



Array 
Element 
Number 


Contents 


1 


Number of elements of results 
you want returned (0 through 
15) 


2 


Number of records read from 
sort or merge input files 


3 


Number of records deleted by 
an owncode 1 routine 


4 


Number of records inserted by 
an owncode 1 routine 


5 


Number of records inserted by 
an owncode 2 routine 


6 


Number of records sorted or 

merged 


7 


Number of records deleted by 
an owncode 3 routine 


8 


Number of records inserted by 
an owncode 3 routine 


9 


Number of records inserted by 
an owncode 4 routine 


10 


Reserved 


11 


Number of records deleted by 
an owncode 5 routine 


12 


Number of records combined by 




summing 


13 


Number of records written to 
output file 


14 


Minimum record length in 
characters 


15 


Average record length in 
characters 


16 


Maximum record length in 
characters 
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SM5MERG 

Execution of the SM5MERG procedure signals the 
beginning of a merge specification. The SM5MERG 
procedure must be the first procedure called for a 
merge. The format of the SM5MERG call is shown in 
figure 5-2. 



CALL SM5MERG(option) 

option Result array name (1 to 7 letters or digits, 

beginning with a letter) or the integer 0. 



Figure 5-2. SM5MERG Format 



The input files for a merge must be presorted. 
Input files for a merge with summing must be 
presorted and presummed. 

The array asociated with the SM5MERG procedure is a 
16-element integer array that returns merge statis- 
tics and results to your program when the merge is 
completed. You set the first element of the result 
array to the number of elements (as many as 15) in 
which you want to receive information. If you set 
the first element to or specify CALL SM5MERG(0), 
no statistics or results are returned. The type of 
result that is returned in each element is shown in 
table 5-1. Note that the array is not set by Sort/ 
Merge until the end of the merge. 



SM5FROM 

Execution of the SM5FR0M procedure specifies the 
input files from which the records to be sorted or 
merged are read. The format of the SM5FROM call is 
shown in figure 5-3. 



CALL SM5FROM('file1'[,'file2'] . . . ) 



'file' 



File name; 1 to 7 letters or digits, beginning 
with a letter. 



Figure 5-3. SM5FROM Format 

You can specify as many as 100 files with one 
SM5FR0M procedure, or you can call the SM5FR0M 
procedure as many as 100 times. The files are read 
in the order that you specify them; a file cannot 
be specified more than once for a merge. The files 
are rewound before and after use unless the name of 
the file is INPUT or a FILE control statement 
parameter specifies otherwise. If a file is open 
when Sort/Merge is called, it is not rewound after 
use because the CF value in the FIT is undetermined. 

Sort/Merge assumes that the files you specify with 
the SM5FR0M procedure are CRM block type C and 
record type Z with FL of 150 characters or less. 
If you specify files that have different character- 
istics, you must describe these files to Sort/Merge 
by including FILE control statements in the control 
statement section of your job. You should open the 
FROM files before doing a sort or merge to be sure 
that Sort/Merge gets passed the correct file 
attributes. The files are not read past embedded 



end-of-record or end-of-file marks (see the CRM 
Basic Access Methods reference manual). 

If the SM5FR0M procedure is not called, records to 
be sorted are read from the file OLD (unless an 
owncode routine supplies records) . An empty 
SM5FR0M file results in a null sort. The SM5FROM 
file cannot be the same as the SM5T0 file. 



SM5TO 

Execution of the SM5T0 procedure specifies the file 
to which sorted or merged records are written 
(unless an owncode routine processes all records). 
The format of the SM5T0 call is shown in figure 5-4. 



CALL SM5TO('file') 



'file' 



File name; 1 to 7 letters or digits, beginning 
with a letter. 



Figure 5-4. SM5TO Format 

The file is not rewound before or after use unless 
the name of the file is OUTPUT or a FILE control 
statement parameter specifies otherwise. Sort/ 
Merge assumes that the file you specify with the 
SM5T0 procedure is CRM block type C and record type 
Z with FL of 150 characters or less. If you 
specify a file with different characteristics, you 
must describe the file to Sort/Merge by including a 
FILE control statement in the control statement 
section of your job. You should open the TO file 
before doing a sort or merge to be sure that 
Sort/Merge gets passed the correct file attributes. 

Sort/Merge writes the file directly, and the file 
is closed when the sort or merge is completed 
unless the name of the file is INPUT. If your 
program also reads or writes the file, you must 
include an OPEN or REWIND statement in your program 
after calling the procedures. If the SM5T0 proce- 
dure is not called, records are written to the file 
NEW (unless an owncode routine processes all 
records). The SM5T0 file cannot be the same as the 
SM5FR0M file. 



SM5KEY 

Execution of the SM5KEY procedure specifies a 
single key field for the sort or merge. The format 
of the SM5KEY call is shown in figure 5-5. 



CALL SM5KEY(first,length,'type','ad') 

first First byte or bit of the key field. 

length Number of bytes or bits in the key field. 

'type' Name of a numeric data format or collating 

sequence. 

'ad' Order, either 'A' for ascending or 'D' for 

descending. 



Figure 5-5. SM5KEY Format 
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In the SM5KEY procedure call, you specify the first 
byte or bit of the key field, the length of the 
field in bytes or bits, the key type (the name of a 
collating sequence or a numeric data format) , and 
the sort order. You must specify the key charac- 
teristics in the order shown. 



called, diagnostic messages are written to the file 
OUTPUT. If you specify the file $NULL with the 
SM5E procedure, diagnostic messages are not written. 



SM5EL 



You specify first and length as integers; the 
leftmost byte or bit in a record is counted as 
number 1. For character data, each character is 
six bits and occupies one byte. For numeric data, 
first and length refer to bytes except for formats 
BINARY_BITS and INTEGER.J8ITS. You must specify the 
first byte or bit of a key field. If you do not 
specify the length, length defaults to 1. 

The key type is the name of a predefined collating 
sequence or your own collating sequence defined by 
SM5SEQx procedures, or the name of a numeric data 
format. The name must be enclosed in apostrophes. 
The default type is the ASCII6 collating sequence. 
See section 2 for a list of predefined collating 
sequences and numeric data formats. 

The sort order is either ascending or descending, 
and you specify 'A' or 'D' , respectively. The 
default order is ascending. For numeric keys 
sorted in ascending order, the record having the 
key with the highest value is written last on the 
output file. Ascending character keys are sorted 
according to the collating sequence you specify. 
For numeric keys sorted in descending order, the 
record having the key with the lowest value is 
written last on the output file. Descending 
character keys are sorted in reverse order of the 
collating sequence you specify. 

You can call the SM5KEY procedure as many as 100 
times during a sort or merge to specify multiple 
sort keys. Output records are sorted or merged 
according to the key field described by the first 
SM5KEY procedure called, then according to the key 
field described by the second SM5KEY procedure 
called, and so on. The total number of key char- 
acters must be less than 256 (if you also specify 
sum fields, the total number of characters in the 
key and sum fields together must be less than 
256). Unless the SM5SEQA procedure is used, key 
fields can overlap one another. If the SM5KEY 
procedure is not called, the entire record is used 
as a character key field, and the default key type 
and sort order are used. 



SM5E 

Execution of the SM5E procedure specifies the file 
to which diagnostic messages are written. The 
format of the SM5E call is shown in figure 5-6. 



CALL SM5E('file') 












'file' 


File 
with 


name; 1 
a letter. 


to 7 letters 


or 


digits. 


beginning 



Figure 5-6. SM5E Format 

The file is written in CRM BT=C, RT=Z, and FL=72 
format. The file is not rewound before or after 
use unless a FILE control statement parameter 
specifies rewind. If the SM5E procedure is not 



Execution of the SM5EL procedure specifies the 
error level to be reported. The format of the 
SM5EL call is shown in figure 5-7. 



CALL SM5EL(error-level) 
error -level 



Alphabetic character enclosed in apostrophes 
or integer (see table 5-2). 



Figure 5-7. SM5EL Format 

The error levels that you can select are shown in 
table 5-2. You can specify the alphabetic charac- 
ter enclosed in apostrophes or the integer. For 
example if you specify 'W or 2, any warning, 
fatal, and catastrophic error messages are re- 
ported. Errors are written to the file specified 
by the SM5E procedure or, if the SM5E procedure is 
not called, to the file OUTPUT. If the SM5EL 
procedure is not called, errors of levels T, W, F, 
and C are reported. See appendix B for an explana- 
tion of the four levels of errors. 



TABLE 5-2. ERROR LEVEL SPECIFICATION 



Error Level 


Errors Reported 


'T' or 1 


T, W, F, C 


'W or 2 


W, F, C 


'F' or 3 


F, C 


'C or 4 


C 



SM5ENR 

Execution of the SM5ENR procedure specifies the 
estimated number of records to be sorted or 
merged. The format of the SM5ENR call is shown in 
figure 5-8. 



CALL SM5ENR (integer) 
integer 



Number of records to be sorted or merged; 
to 1000000000. 



Figure 5-8. SM5ENR Format 

The integer you specify is the approximate number 
of records to be sorted or merged. If SM5ENR is 
specified as less than 1500, Sort/Merge uses less 
memory for the initial sort phase. This causes 
noticeably less memory required for the entire sort 
if the actual number of records is a low number. 
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SM5FAST 

Execution of the SM5FAST procedure can specify that 
certain sort input and output records are to be 
read and written directly by Sort/Merge rather than 
by means of CYBER Record Manager (CRM). The 
SM5FAST procedure is ignored during a merge. The 
format of the SM5FAST call is shown in figure 5-9. 



CALL SM5FAST(option) 
option 



'YES' or V 
'MO' or 'N' 



Figure 5-9. SM5FAST For mat 



The option can be 'YES' or 'NO' (or '1' or 'N'). 

I If the option is 'YES', certain sort input and 

output records are read and written directly by 

Sort/Merge. If the option is 'NO', CRM is used. 

Files processed by the SM5FAST procedure must 
reside on mass storage. The records in these files 
must be block type C and record type F, or block 
type I and record type W (see the CRM Basic Access 
Methods reference manual for detailed infor- 
mation). All input files must have an identical 
record type and record length. If the file resides 
on tape, or if the records are not all the same 
type and length, a warning diagnostic is issued and 
the SM5FAST option is canceled. The files are then 
processed using CRM. Sort/Merge obtains block and 
record type information from the file information 
table (FIT); a FILE control statement is not 
ignored. Calling the SM5FAST procedure with 'YES' 
results in increased speed, but not all errors are 
diagnosed; use this procedure when you are sure 
your files are correctly written and described. 



SM5NODA 

Execution of the SM5N0DA procedure specifies that 
Sort/Merge dayfile messages are to be suppressed. 
The format of the SM5N0DA call is shown in figure 
5-10. 



CALL SM5NODA 



The integer you specify is the exact number of 
characters in each record; a catastrophic error 
results if a record from an owncode routine does 
not have the exact number of characters. If the 
SM50FL procedure is not called, records from an 
owncode routine can be no longer than the longest 
allowed input or output record. You cannot call 
both the SM50FL procedure and the SM50MRL procedure 
in the same sort or merge. 



SM50MRL 

Execution of the SM50MRL procedure specifies the 
maximum length of any record from an owncode 
routine. The format of the SM50MRL call is shown 
in figure 5-12, ..._ 



CALL SM50MRL(integer) 



Figure 5-12. SM50MRL Format I 

The integer you specify is the maximum record 
length in characters. (The SM50FL procedure is 
recommended if all records from an owncode routine | 
are the same length.) The SM50MRL procedure need 
not be called if the sort or merge has an input or 
output file with a maximum record length at least 
as long as the record length specified by this 
procedure. If the SM50MRL procedure is not called, 
records from an owncode routine can be no longer | 
than the longest allowed input or output record. 
You cannot call both the SM50MRL procedure and the 
SM50FL procedure in the same sort or merge. | 



SM50WNn 

Execution of the SMSOWNn procedure specifies an 
owncode routine that is executed each time a 
certain point is reached during the sort or merge. 
The format of the SM50WNn call is shown in figure 
5-13. I 



Figure 5-10. SM5NODA Format 



CALL SM50WNn(proc) 












n 


1, 2, 3 r 4, or 5 












proc 


Owncode routine 
beginning with a 


name; 
letter. 


1 to 7 


letters 


or 


digits. 



SM50FL 

Execution of the SM50FL procedure specifies the 
number of characters in fixed length records from 
an owncode routine. The format of the SM50FL call 
is shown in figure 5-11. 



CALL SM50FL(integer) 



Figure 5-11. SM50FL Format 



Figure 5-13. SM50WNn Format 

The procedure you specify is the name (address) of 
the owncode routine; in a FORTRAN program, the name 
must be declared in an EXTERNAL statement. The n 
associated with the SM50WNn call must be 1, 2, 3, 
4, or 5. If the SM50WNn procedure is not called, 
no owncode routine is executed. 



SM5RETA 

Execution of the SM5RETA procedure can specify that 
records with equal sort keys are output in the same 
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order as they are input. The format of the SM5RETA 
call is shown in figure 5-14. 



CALL SM5RETA<option) 

option 'YES' or V 

"NO" or 'N' 



| Figure 5-14. SM5RETA Format 

The option can be 'YES' or 'NO' (or 'Y' or 'N'). 
If the option is 'YES', records with equal keys 
retain their original order. If the option is 
'NO', records with equal keys might not retain 
their original order. 

If RETAIN=YES and you specify more than one sort or 
merge input file with the SM5FR0M procedure, the 
order in which you specify the input files is the 
order in which records with equal keys are output. 
If the SM5RETA procedure is not called, records 
with equal keys might not be output in the same 
order as they are input. 

I You cannot specify both the SM5RETA procedure and 
the SM5SUM procedure in the same, sort or merge. If 
you do specify both, a catastrophic error occurs. 

SM5SEQx 

Execution of a series of SM5SEQx procedures 
specifies a user-defined collating sequence that is 
referenced by the SM5KEY procedure. The formats of 
I the SM5SEQx calls are shown in figure 5-15. 



CALL SM5SEQN('name') 

CALL SM5SEQS{'char' 'char') 



[CALL SM5SEQRCYES') or CALL SM5SEQR{'Y') 
[CALL SM5SEQACYES') or CALL SM5SEQA('Y') 



name 



'char' 



Collating sequence name; 1 to 31 letters, 
digits, or the special characters ? # @ — . 
Only 10 characters are significant and the 
first must be a letter. 

Character in the collating sequence. 



Figure 5-15. SM5SEQx Formats 

The SM5SEQN procedure names your collating sequence. 
The name is a literal enclosed in apostrophes; the 
name cannot be the same as the name of one of the 
predefined collating sequences. The SM5SEQN proce- 
dure must be the first called in the series of 
SM5SEQx procedures. 

Collating positions are assigned to the characters 
in your collating sequence by the SM5SEQS proce- 
dure, which can be called more than once. Each 
SM5SEQS procedure specifies a value step in the 
sequence. A value step consists of one or more 
characters, and characters specified in the same 
step collate equally. Characters specified with 
the first SM5SEQS procedure called collate first, 



characters specified with the second SM5SEQS 
procedure called collate second, and so on. The 
following paragraphs describe how to specify steps 
in your collating sequence with SM5SEQS procedures. 

You can specify a value step consisting of one 
character by a graphic character (see appendix A) 
enclosed in apostrophes as in the following example: 

CALL SM5SEQS('A') 

You can specify a value step consisting of several 
characters by single characters enclosed in 
apostrophes and separated by commas. The following 
example specifies a step consisting of the blank 
and the digits 0, 1, 2, and 3, all of which collate 
equally: 

CALL SM5SEQSC ' ,'0','1','2','3') 

If the SM5SEQR procedure is called, equal collating 
position is assigned to any characters not 
specified by SM5SEQS procedures. For example, if 
you define a collating sequence that includes 
digits and letters but not any of the special 
characters (such as commas, periods, slashes), a 
call to SM5SEQR includes the special characters in 
your collating sequence. The special characters 
all collate equally. The SM5SEQR procedure can 
only be called once for each call to SM5SEQN; the 
SM5SEQR procedure can be called anywhere in the 
SM5SEQx series. 

If the SM5SEQA procedure is called, characters in 
the same value step are altered on output to the 
first character in the step. The following example 
alters all asterisks and ampersands to slashes: 

CALL SM5SEQSC/', '*','&') 
CALL SM5SEQACYES') 

The SM5SEQA procedure can only be called once for 
each call to SM5SEQN; the SM5SEQA procedure can be 
called anywhere in the SM5SEC)x series. 

Your collating sequence specification is terminated 
by any procedure call other than SM5SEQS, SM5SEQR, 
or SM5SEQA. You can define more than one collating 
sequence by calling a separate series of SM5SEQx 
procedures for each collating sequence. The name 
of each collating sequence must be unique. If no 
SM5SEQx procedures are called, a nonstandard 
collating sequence is not defined. 



SM5ST 

Execution of the SM5ST procedure specifies an 
integer variable that is set to a value represent- 
ing the highest level of error that occurred during 
the sort or merge. The format of the SM5ST call is 
shown in figure 5-16. | 



CALL SM5ST(variable) 

variable Symbolic name of an integer variable; 1 to 

7 letters or digits, beginning with a letter. 



Figure 5-16. SM5ST Format 
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The error level that Is represented by the value 
returned to the SM5ST procedure Is shown In table 
5-3. For example if a 3 Is returned to the SM5ST 
procedure, a fatal error occurred during the sort 
or merge. If you call the SM5ST procedure, Sort/ 
Merge does not abort if a catastrophic error occurs 
before any data records are input. However, if 
Sort/Merge calls another product and an unrecover- 
able error results, an abnormal job termination 
will occur. For example, if Sort/Merge calls a 
product, such as Common Memory Manager (CMM) , and 
CMM processing results in an error, a termination 
will occur. 

TABLE 5-3. ERROR LEVEL CODES, SM5ST CALL 



Error Level 


Code 


No errors 







Trivial 


10 




Warning 


20 




Fatal 


30 




Catastrophic 


40 





SM5SUM 

Execution of the SM5SUM procedure specifies fields 
that are to be summed in records with equal key 
values. Input files for a merge with summing must 
be presorted and presummed. As many as 255 bytes 
can be summed. The records with all key fields 
equal are combined into one new record, and the 
other records with equal keys are deleted. The one 
resultant record contains the key fields and the 
fields that are the sums of the specified fields 
from all the records with equal keys; a data field 
that is not a key field or a sum field is set to 
the corresponding field from one of the old records. 
The format of the SM5SUM call is shown in figure 
5-17. 



All the fields to be summed must contain numeric 
data; otherwise, the contents of the new field are 
undefined. The fields described as sum fields 
cannot also be key fields. 



The SM5SUM procedure call specifies the first byte 
or bit of the sum field, the length of the sum 
field in bytes or bits (length can be a maximum of I 
17 bytes), the type of data in the sum field (the | 
name of a numeric data format except REAL) , and the 
number of fields to be summed. See section 2 for a 
list of numeric data formats. 



If you specify multiple fields with one SM5SUM 
procedure, the fields must be consecutive, be the 
same length, and contain the same type of numeric 
data. Sum fields cannot overlap one another. If a 
sum field contains no data because a record is 
short, the sum for that field is undefined. 



Figure 5-18 shows an example of an SM5SUM procedure 
call. Part A of figure 5-18 shows the layout of 
the record containing fields to be summed. Part B 
shows three SM5SUM procedure calls, each describing 
one field to be summed. Part C shows one equiva- 
lent SM5SUM procedure call that describes the three 
consecutive fields to be summed. 



If the summing of the specified fields results in 
new numeric values that do not fit into the sum 
fields, a fatal error results. One of the records 
that caused the overflow is deleted as usual, but 
the sum field contents in the remaining record are 
undefined. A diagnostic message indicating which 
field caused the overflow is issued, and the job is 
terminated at the end of the sort (unless you call 
the SM5ST procedure) . 



CALL SM5SUM(first,length,'type',rep) 

first First byte or bit of the sum field. 

length Number of bytes or bits in the sum field. 

'type' Name of a numeric data format. 

rep Number of fields to be summed. 



Figure 5-17. SNI5SUM Format 



You can call the SM5SUM procedure as many as 100 
times during a sort or merge to specify different 
sum fields. If the SM5SUM procedure is not called, 
records with equal key values are not automatically 
combined into single records. You cannot call both 
the SM5SUM procedure and the SM50WN5 procedure in 
the same sort or merge. 



You cannot specify both the SM5RETA and the SM5SUM 
procedure in the same sort or merge. If you do 
specify both, a catastrophic error occurs. 
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A. Record Layout 



10 



15 



20 



Student number 
(sort key) 



Number of 
units registered 



25 



Number of 
units completed 



Grade points 



D 



B. SM5SUM Procedure Calls 

CALL SM5SUM(11,5, 'INTEGER', 1) 
CALL SM5SUM(16,5, 'INTEGER', 1) 
CALL SM5SUM(21 ,5, 'INTEGER', 1) 

C. SM5SUM Procedure Call 

CALL SM5SUM0 1,5, 'INTEGER', 3) 



Figure 5-18. SM5SUM Procedure Call Example 



SM5END 

Execution of the SM5END procedure terminates your 
sort or merge specification and initiates Sort/ 
Merge processing. The format of the SM5END call is 
shown in figure 5-19. The SM5END procedure must be 
the last called for any one sort or merge. 



CALL SM5END 



Figure 5-19. SM5END Format 
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COBOL INTERFACE 



Two options are available for using Sort/Merge 5 
from COBOL 5: a control statement option when you 
use the COBOL SORT or MERGE statement and direct 
calls. This section describes these two options. 

COBOL5 CONTROL STATEMENT 
OPTION 

Sort /Merge is used by COBOL when the COBOL SORT or 
MERGE statement is included in your program. You 
can select Sort/Merge 5 by means of a C0B0L5 
control statement option. If you specify S0RT5 in 
your C0B0L5 control statement, Sort/Merge 5 is used 
when the SORT or MERGE statement in your program 
executes. Figure 6-1 shows a sample C0B0L5 control 
statement that includes the S0RT5 option. See the 
COBOL 5 reference manual for information on coding 
the SORT or MERGE statement in a program. 



COBOL5,I=PROGA,SORT5,L=REPTO. 



Figure 6-1. COBOL5 Control Statement 
Example 



DIRECT CALLS 



Direct calls from a COBOL 5 program to the Sort/ 
Merge procedures described in section 5 can be made 
with ENTER FTN5 SM5xxx statements. Calls to the 
procedures cannot be mixed with the SORT or MERGE 
statement; the procedures cannot be called in a 
COBOL input or output procedure, and the SORT or 
MERGE statement cannot be executed in a series of 
direct calls (before SM5END is called). See the 
COBOL 5 reference manual for information on coding 
ENTER statements. 



All files to be sorted or merged must be sequential 
files. The default file characteristics are block 
type C, record type Z, and full length of 150 
characters or less. For files with other block 
types and record types, you must include CYBER 
Record Manager (CRM) FILE control statements in the 
control statement section of your job (see the CRM 
Basic Access Methods reference manual). 
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OWNCODE ROUTINES 



You can write a routine to insert, substitute, 
modify, or delete input and output records during 
Sort/Merge processing. Your routine , called an 
owncode routine, is executed each time the sort or 
merge reaches a certain point. Sort/Merge passes a 
record to the owncode routine, which processes the 
record. When the record is returned to Sort/Merge 
from the owncode routine, Sort/Merge processes the 
record according to an option specified by the 
owncode routine. Owncode routines can also supply 
the records to be sorted; when Sort/Merge is ready 
for a record, the owncode routine passes a record 
to Sort/Merge. 

Owncode routines are routines written in FORTRAN 
(subroutine subprograms) or some other language 
that have been compiled and saved in relocatable 
binary form. The file containing your owncode 
routines is automatically loaded during Sort/Merge 
processing. This section describes specifying 
owncode routines and the available processing 
options. 



SPECIFYING OWNCODE ROUTINES 

To specify owncode routines when you are using 
control statement calls to Sort/Merge, you use the 
OWNF parameter. The OWNF parameter gives Sort/ 
Merge the name of the file containing your owncode 
routines; the file is loaded by Sort/Merge by means 
of the user call loader so that the routines are 
available during Sort/Merge processing. The names 
of your owncode routines are specified with the 
OWNn parameter; n is an integer from 1 through 5 
that tells Sort/Merge at which point in processing 
the routine is executed. You must supply a sepa- 
rate subroutine for each OWNn specified. 

When you are using procedure calls to Sort/Merge, 
you call SM50WNn to specify the name of an owncode 
routine and to indicate at which point in process- 
ing the routine is executed. Owncode routines must 
be loaded along with the Sort/Merge procedures. 
You cannot use AAM to process files within an 
owncode routine when executing a control card 
Sort/Merge. In a FORTRAN program, you must name 
the owncode routines in an EXTERNAL statement. You 
cannot call SM50WNn from a COBOL program because 
there is no way (other than CALL or ENTER) to tell 
COBOL the name of an external subroutine. You can 
write a subroutine in FORTRAN or some other 
language to call the owncode routine. 

Owncode exits 1 and 2 can be taken from a sort 
only; exits 3, 4, and 5 can be taken from a sort or 
merge. 



OWNCODE ROUTINE PARAMETERS 

Owncode routines are called with parameters. Up to 
five parameters are passed between Sort/Merge and 
your owncode routine. Parameters are passed at the 



point in processing at which your owncode routine 
is executed. Figure 7-1 shows the format for 
naming an owncode routine in a control statement 
and in a procedure call, and the subroutine state- 
ment format, which is a standard FORTRAN subroutine 
statement . 



OWNn=proc 



CALL SM50WNn(proc> 



SUBROUTINE proc(return_code,reca,rla[,recb,rlb] ) 



Figure 7-1. Owncode Routine Call and Subroutine 
Statement Formats 

If you specify an owncode 1, owncode 2, owncode 3, 
or owncode 4 routine, the return_code, reca, and 
rla parameters are passed by Sort/Merge. If you 
specify an owncode 5 routine, the recb and rib 
parameters are passed in addition to the other 
three parameters. The parameters are described in 
the following paragraphs. 

The return_code parameter is passed by Sort/Merge 
to an owncode routine as an integer with value 0. 
The return_code parameter can be altered by the 
owncode routine to the integer value 1, 2, or 3. 
The value returned to Sort/Merge by this parameter 
indicates a specific action to be taken by Sort/ 
Merge. A return_code value that is not defined 
causes a catastrophic error. The meanings of the 
various return_codes are discussed later in this 
section. 

The reca parameter is an otherwise empty array or 
string variable that is used to pass the current | 
record; except for the current record, the contents 
of reca are undefined. The rla parameter passes a 
value that is the number of characters in the 
current record being sorted or merged. 

The recb and rib parameters are used when proc- 
essing two records with equal keys. The recb 
parameter passes the second record; the rib 
parameter passes a value that is the number of 
characters in the second record. 

The allowed length of records passed to an owncode 
routine depends on how you have specified record 
length. If you have specified the OWNFL parameter 
or have called the SM50FL procedure, the number of 
characters in the current record must be the same 
as the CWNFL or SM50FL value. Otherwise, the 
maximum record length is determined as the largest 
MRL or FL FIT field in a CYBER Record Manager FILE 
control statement, or the largest value from the 
OWNMRL parameter or the SM50MRL procedure; all 
records must contain between one and this maximum 
record length number of characters, inclusive. An 
rla or rib parameter value that does not correspond 
to a record specification causes a catastrophic 
error. 
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The reca, rla, recb, and rib parameters can be 
altered by an owncode routine; the routine can pass 
a different record back to Sort/Merge in reca or 
recb, and the number of characters in the record 
can be different. The parameters must be passed 
from an owncode routine in order: return_code, 
reca, rla, recb, and rib. The arrays reca and recb 
can be any type of array. 

Table 7-1 summarizes the owncode routines and the 
parameters passed. Figure 7-2 illustrates record 
movement from Sort/Merge to an owncode routine and 
back to Sort/Merge. 

OWNCODE 1: PROCESSING 
INPUT RECORDS 

The 0WN1 parameter or the SM50WN1 procedure call 
names an owncode 1 routine that is executed in one 
of two instances . 

If you have specified input files with the FROM 
parameter or the SM5FR0M procedure call, the 
owncode 1 routine is executed after reading each 
record. The return_code, reca, and rla parameters 
are passed to the routine by Sort/Merge. The 
return code is 0, reca contains the record, and rla 
is the" record length in characters. After owncode 



processing of the record, control returns to 
Sort/Merge, which processes the record passed back 
in reca according to the return_code value set by 
the owncode 1 routine (the record passed back to 
Sort/Merge in reca can be different from the record 
passed to the routine). The return_code value and 
the associated processing performed by Sort/Merge 
can be as follows: 



The record passed back to Sort/Merge in 
reca is sorted. 

1 The record passed back to Sort/Merge in 
reca is deleted. 

2 An additional record is inserted into the 
sort. The record in reca is entered into 
the soft, and" the owncode 1 routine is 
executed again with reca and rla set to the 
record that just entered the sort. 

3 Input from the current file is terminated. 
The record in reca and remaining records in 
the file are not sorted. If more input 
files are specified, records are read from 
the next input file. The owncode 1 routine 
is executed after reading each record from 
this next file. 



TABLE 7-1. OWNCODE ROUTINE SUMMARY 



Routine 
Type 


Processing 


Parameters Passed 


Return code Value 


Return_code 


reca 


rla 


recb 


rib 


Owncode 1 


Input records 


X 


X 


X 






Sort current record. 

1 Delete current record. 

2 Insert new record. 

3 Terminate input from 
current file* 


Owncode 2 


Input files 


X 


X 


X 






Begin processing next 
input file. 

1 Insert new record. 


Owncode 3 


Output records 


X 


X 


X 






Modify current record. 

1 Delete current record. 

2 Create new record. 

3 Terminate output. 


Owncode 4 


Output files 


X 


X 


X 






Sort or merge is complete. 

1 Insert new record. 


Owncode 5 


Equal keys 


X 


X 


X 


X 


X 


Retain both records. 

1 Replace both records with 
new record. 
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Figure 7-2. Owncode Routine Record Flow 



If you have not specified any input files, the 
owncode 1 routine is executed when Sort/Merge 
is ready for another record to process. The 
return_code, reca, and rla parameters are passed to 
the routine hy Sort/Merge. The return_code is 0, 
reca is an empty array with room for the largest 
record, and rla is 0. When control is returned 
to Sort/Merge from the owncode 1 routine, the 
return_code value and the associated processing 
performed by Sort/Merge can be as follows: 

The record passed back to Sort/Merge in 
reca is sorted. 

2 An additional record is inserted into the 
sort. The record in reca is entered into 
the sort, and the owncode 1 routine is 
executed again with reca and rla set to the 
record that just entered the sort. 

3 Input is terminated. 



OWNCODE 2: 
INPUT FILES 



PROCESSING 



The 0WN2 parameter or the SM50WN2 procedure call 
names an owncode 2 routine that is executed in one 
of two instances . 

If you have specified input files with the FROM 
parameter or the SM5FROM procedure call , the 
owncode 2 routine is executed after input from a 
file has terminated (input terminates when end- 
of-sectlon is found on file INPUT, when end-of-file 
is found on any other file, or when an owncode 1 
routine passes a return_code value of 3 to Sort/ 
Merge). The return_code, reca, and rla parameters 
are passed to the routine by Sort/Merge. The 
return_code is 0, and reca and rla are passed as a 
null record; reca is an empty array, and record 
length is 0. When control is returned to Sort/ 
Merge from the owncode 2 routine, the return_code 
value and the associated processing performed by 
Sort/Merge can be as follows: 



Processing of the next input file, if any, 
begins . 

1 An additional record is inserted into the 
sort after the last record. The record 
inserted is the first rla characters in 
reca, which have been provided by the 
routine. The owncode 2 routine is executed 
again. 

If you have not specified any input files, the 
owncode 2 routine is executed after an owncode 1 
routine has terminated input. The return_code, 
reca, and rla parameters are passed to the routine 
by Sort /Merge. The return_code is 0, and reca and 
rla are passed as a null record. When control is 
returned to Sort/Merge from the owncode 2 routine, 
the return_code value and the associated processing 
performed by Sort/Merge can be as follows: 

Signals the end of input. 

1 An additional record is inserted into the 
sort after the last record. The record 
inserted is the first rla characters in 
reca, which have been provided by the 
routine. The owncode 2 routine is executed 
again. 

OWNCODE 3: PROCESSING 
OUTPUT RECORDS 

The 0WN3 parameter or the SM50WN3 procedure call 
names an owncode 3 routine that is executed in one 
of two instances . 

If you have specified an output file with the TO 
parameter or the SM5T0 procedure call, the own- 
code 3 routine is executed before writing a record 
to the output file. The return_code, reca, and rla 
parameters are passed to the routine by Sort/ 
Merge. The return_code is 0, reca is the record, 
and rla is the record length in characters. After 
owncode processing of the record, control returns 
to Sort/Merge, which processes the record passed 
back in reca according to the return_code value set 
by the owncode 3 routine. The return_code value 
and the associated processing performed by Sort/ 
Merge can be as follows: 

The record passed back to Sort/Merge in 
reca is written to the output file. 

1 The record passed back to Sort/Merge in 
reca is deleted. 

2 An additional record is written to the 
output file. The record in reca is written 
out, and the owncode 3 routine is executed 
again with reca and rla set to the original 
record. 

3 Output from the current file is termi- 
nated. The record in reca is not written 
out. If an owncode 4 routine is specified, 
it is executed; otherwise, the sort or 
merge is terminated. 
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If you have not specified an output file, the 
owncode 3 routine is executed when a record is 
ready for output; sorted or merged records are 
processed by the routine. The return_code , reca, 
and rla parameters are passed to the routine by 
Sort/Merge. The return_code is 0, reca is the 
record, and rla is the record length in char- 
acters. When control is returned to Sort/Merge 
from the owncode 3 routine, the return_code value 
and the associated processing performed by Sort/ 
Merge can be as follows: 

1 The record passed back to Sort/Merge in 
reca is deleted. 

3 Output is terminated. If an owncode 4 
routine is specified, it is executed; 
otherwise, the sort or merge is terminated. 



OWNCODE 4: PROCESSING 
OUTPUT FILES 

The 0WN4 parameter or the SM50WN4 procedure call 
names an owncode 4 routine that is executed in one 
of two instances . 

If you have specified an output file with the TO 
parameter or the SM5T0 procedure call, the owncode 
4 routine is executed after the last record has 
been written to the output file. The return_code, 
reca, and rla parameters are passed to the routine 
by Sort/Merge. The return_code is 0, and reca and 
rla are passed as a null record. When control is 
returned to Sort/Merge from the owncode 4 routine, 
the return_code value and the associated processing 
performed by Sort/Merge can be as follows: 

The sort or merge is completed. 

1 An additional record is inserted after the 
last record. The record inserted is the 
first rla characters in reca. The owncode 
4 routine is executed again. 

If you have not specified an output file, an 
owncode 4 routine is executed after the last call 
to an owncode 3 routine indicating that the sort 
has been completed. If output is terminated by an 
owncode 3 routine, an owncode 4 routine is called 
immediately. The return_code, reca, and rla 
parameters are passed to the routine by Sort/Merge. 
The return_code is 0, and reca and rla are passed 
as a null record. When control is returned to 
Sort/Merge from the owncode 4 routine, the 
return_code value and the associated processing 
performed by Sort/Merge can be as follows: 



The sort or merge is completed. 



1 This value is not allowed since no output 
file has been specified. 



OWNCODE 5: PROCESSING 
RECORDS WITH EQUAL KEYS 

The 0WN5 parameter or the SM50WN5 procedure call 
names an owncode 5 routine that is executed when 
two records with equal key values are encountered 
during a sort or merge (when you have defined your 
own collating sequence, key values can be equal 

even if key._cMrACiejs__are__not..jLd^ntical)_. The key 

fields must not be modified or else the sorting 
order is undefined. The return_code, reca, rla, 
recb, and rib parameters are passed to the routine 
by Sort/Merge. The return_code is 0; reca and recb 
contain the first and second records, respectively, 
and rla and rib contain the record lengths in 
characters of the first and second records, 
respectively. After owncode 5 routine processing 
of the two records, control is returned to 
Sort/Merge, which processes the records according 
to the return_code value set by the owncode 5 
routine. The return_code value and the associated 
processing performed by Sort/ Merge can be as 
follows : 

The first rla characters of reca are 
accepted as the first record; the first rib 
characters of recb are accepted as the 
second record (the records and record 
lengths passed back to Sort/Merge can be 
different from the records and record 
lengths passed to the owncode routine). 

1 One duplicate record is deleted. The other 
record is replaced with the first rla char- 
acters of reca. 



If you specify RETAIN=YES or call the SM5RETA. 
procedure in a sort with an owncode 5 routine, the 
record that entered the sort first is passed to the 
owncode routine as reca; otherwise, either of the 
two records with equal keys could be passed to the 
routine as reca. The owncode 5 routine can control 
the order in which the two records are returned to 
Sort/Merge. The record returned to Sort/Merge as 
reca is entered into the sort before the record 
returned as recb. An owncode 5 routine cannot be 
specified in the same sort as a SUM parameter or 
SM5SUM procedure. 
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This section contains examples of sorts and 
merges. The first example is a simple control 
statement sort on one key. The same sort is illus- 
trated using the interactive dialog. A control 
statement sort on multiple keys, a control state- 
ment merge, directive file creation and use, SUM 
parameter use, and a FORTRAN program with Sort/ 
Merge procedure calls and an owncode routine are 
al so included . 



CONTROL STATEMENT SORT ON 
ONE KEY 

Figure 8-1 shows the record layout in a university 
student file named UNIVER. Each record includes 
the last name and first and middle initials, the 
student number, the date of birth, the field of 
study, the grade point average, and a code repre- 
senting class (freshman, sophomore, junior, 
senior); all fields are written with character 
data. The file is maintained with the student 
number as the major key. Records are normally 
ordered in ascending order according to the student 
number as Shown in figure 8-2 with file UNIVER. 

Figure 8-3 shows the job structures for sorting 
file UNIVER to give an alphabetic list of 
students. Under both NOS and NOS/BE operating 
systems, the job statements and accounting infor- 
mation are followed by ATTACH commands to assign 
the file to the job. CYBER Record Manager (CRM) 
FILE control statements are included, because the 
input and output records contain only 38 characters 
each, considerably less than the default of 150. 
The S0RT5 control statement calls for records from 
UNIVER to be sorted on a key that occupies charac- 
ter positions 1 through 10 in each record according 
to the default ASCII6 collating sequence in ascend- 
ing order. Sorted records are written to file 
SRTOUT, which is created as a local file during the 
sort. File SRTOUT is then copied to file OUTPUT 
with a right shift, because the first character in 
the print line is reserved for carriage control. 
Figure 8-4 shows the output from the job. 
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Figure 8-2. File UNIVER 



SORT SPECIFICATION USING 
INTERACTIVE DIALOG 

Figure 8-5 shows the interactive dialog used to 
specify the same sort of file UNIVER on the last 
name. The input file is assigned to the job with 
an ATTACH command under NOS or a FETCH command 
under NOS/BE. CRM FILE control statements are 
entered for the input and output files. The dialog 
is invoked by typing DIAL0G=YES. Sorted records 
are written to file S0RT0UT, which Sort/Merge 
creates as a local file. File SORTOUT can be 
printed or displayed at the terminal; SORTOUT can 
also be routed to a printer or saved as a permanent 
file. 
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LAST NAME 
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Figure 8-1. File UNIVER Record Layout 
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NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH,UNIVER. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT,KEY=1. .10 

COPYSBF,SRTOUT,OUTPUT. 

EOI 

NOS/BE Operating System 

Job statement 

ACCOUNT statement 

ATTACH,UNIVER,ID=PUBS. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BI=C,RT=Z f FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT,KEY=1. .10 

COPYSBF,SRTOUT,OUTPUT. 

EOI 



Figure 8-3. Job Structure for Sorting File 
UNIVER on Last Name 
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Figure 8-4. File UNIVER Sorted on Last Name 



/attach, univer 

/fiLe(univer,bt=c,rt=z / fl=38) 

FILECUNIVER,BT=C / RT=Z,FL=38> 

/•file(sortout,bt = c,rt=z,fl=38) 

FILE(S0RT0UT,BT=C,RT=Z,FL=38> 

/sort5.dialog=yes 
IS YOUR TERMINAL ALREADY SET TO NORMAL MODE OR UPPERCASE 
ASCII MODE. ALSO, ARE YOU SURE THAT ALL YOUR FILES (IF ANY) 
ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE 
CONTROL STATEMENTS SPECIFIED FOR THEM 

? yes 
DO YOU 



JUST ONE INPUT FILE AND NO 0WN1 
NAME OF YOUR INPUT FILE 
ANY 0WN3 OR 0WN4 SUBROUTINES 
NAME OF YOUR OUTPUT FILE 



OR 0WN2 SUBROUTINES 



HAVE 
? yes 

WHAT, IS THE 
? univer 

DO YOU HAVE 
? no 

WHAT IS THE 
? sortout 

THE STANDARD COLLATING SEQUENCE IS ASCII6. 

HERE IS THE WHOLE ASCII6 COLLATING SEQUENCE LISTED 
!"#$%&' (>*+,-./ 01 23456789 : ;<=>?aABCDEFGH I J KLMNOPQRSTUVWXYZLAD" 

DO ALL OF YOUR KEYS CONSIST OF CHARACTER DATA TO BE SORTED 

ACCORDING TO THE ASCII6 COLLATING SEQUENCE 
? y es 

ASCENDING ORDER OF THE ASCII6 COLLATING SEQUENCE MEANS THE 

NORMAL ORDER. 
!"#$%S' ()*+,-./01 23456789 :;<=>? 3 ABC DEFGH I J KLMNOPQRSTUVWXYZm "_ 

DESCENDING ORDER MEANS THE REVERSE ORDER. 
-UUZYXWVUTSRQPONMLK J I HGFEDCBAa?>=<; : 9876543210/ .-,+*> C , 8%$#"! 

DO YOU WANT ALL YOUR KEYS SORTED IN ASCENDING ORDER 
? yes 

HOW MANY KEY FIELDS DO YOU HAVE 
? 1 

THE LEFT-MOST CHARACTER OF A RECORD IS NUMBER 1. 

FOR THE MOST IMPORTANT KEY FIELD, WHAT IS THE NUMBER 

OF THE LEFT MOST CHARACTER 
? 1 

HOW MANY CHARACTERS ARE IN THE MOST IMPORTANT KEY FIELD 
? 10 

DO YOU WANT RECORDS WITH EQUIVALENT KEY VALUES TO BE WRITTEN 

IN THE SAME ORDER THEY ARE READ 
? no 

GIVE AN ESTIMATE OF THE MAXIMUM NUMBER OF RECORDS TO BE SORTED 
? 75 

THANK YOU. SORT/MERGE NOW BEGINS. 
S0RT5. DIALOGUES 
/ 



Figure 8-5. Interactive Dialog Example 
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CONTROL STATEMENT SORT ON 
MULTIPLE KEYS 

Figure 8-6 shows the job structures for sorting 
file UNIVER on three keys. Under both NOS and 
NOS/BE, the job statements and accounting informa- 
tion are followed by ATTACH commands to assign the 
file to the job. CRM FILE control statements for 
the input and output files are included. The S0RT5 
control statement calls for records to be first 
sorted on the field of study, which occupies char- 
acter positions 27 through 34 in each record. 
Records with equal keys for the major key are then 
sorted on the class code, which is a 1-character 
field in position 38. The third key sorts students 
with the same field of study and class by the last 
name. 



NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH.UNIVER. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT, 

.KEY=((27. .34),(38,1),{1. .10)) 

COPYSBF,SRTOUT,OUTPUT. 

EOI 



NOS/BE Operating System 

Job statement 
ACCOUNT statement 
ATTACH,UNIVER,ID=PUBS. 
FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT, 

.KEY=((27. .34),(38,1),{1. .10)) 

COPYSBF,SRTOUT,OUTPUT. 

EOI 



Figure 8-6. Job Structure for Control Statement 
Sort on Multiple Keys 

Figure 8-6 illustrates continuing the S0RT5 control 
statement beyond one line. The first line of the 
control statement is terminated with three periods; 
the second line begins with one period. Sorted 
records are written to the file SRTOUT, which is 
then copied to file OUTPUT with a right shift, 
because the first character in the print line is 
reserved for carriage control. Figure 8-7 shows 
the output from the job. 



CONTROL STATEMENT MERGE 

Figure 8-8 shows two files (UNIVER, ADDSTU) ordered 
according to the student number. The two files can 
be merged because they are sorted on the same key. 
Figure 8-9 shows the job structures to merge the 
two files. Under both NOS and NOS/BE, the two 
files are attached. A new file (NEWU) is created 
as a permanent file to which merged records are 
written; under NOS, the DEFINE command creates an 
empty direct access permanent file. Under NOS/BE, 
the REQUEST command assigns NEWU to a permanent 
file device; the CATALOG command then makes the 
file permanent. CRM FILE control statements for 
the input files and the merged file are included. 
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Figure 8-7. File UNIVER Sorted on Multiple Keys 
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B. File ADDSTU 
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Figure 8-8. Input Files for Control Statement Merge 
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8-3 



NOS Operating System 



Job statement 
USER statement 
CHARGE statement 
ATTACH,UNIVER,ADDSTU. 

DEFINE.NEWU. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(ADDSTU,BT=C,RT=Z,FL=38) 

FILE(NEWU,BT=C,RT=Z,FL=38) 

MERGE.FROM=(UNIVER.ADDSTU),TO=NEWU,KEY=15. 

COPYSBF,NEWU,OUTPUT. 

EOI 



NOS/BE Operating System 



.20 



Job statement 

ACCOUNT statement 

ATTACH,UNIVER,ID=PUBS. 

ATTACH,ADDSTU,ID=PUBS. 

REQUEST,NEWU,*PF. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

Fl LE(ADDSTU,BT=C,RT=Z,FL=38) 

FILE(NEWU,BT=C,RT=Z,FL=38) 

MERGE.FROIW=(UNIVER,ADDSTU),TO=NEWU,KEY=15. .20 

CATALOG,NEWU,ID=PUBS,XR=CHNG. 

COPYSBF,NEWU,OUTPUT. 

EOI 



Figure 8-9. Job Structure for Control Statement Merge 



The MERGE control statement names the two input 
files and the new output file. The key on which 
the files are merged is the student number (the 
field on which the files are presorted). The 
merged file is copied to file OUTPUT with a right 
shift, because the first character in the print 
line is reserved for carriage control. Figure 8-10 
shows the output from the job. 
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CREATING AND USING A 
DIRECTIVE FILE 

Figure 8-11 shows a portion of a terminal session 
in which a directive file is created. In the first 
part of figure 8-11, the directive file is created 
using XEDIT under NOS; @) denotes carriage 
return. In the second part of the figure, the 
directive file is created using EDITOR under NOS/BE. 

Under NOS, XEDIT is entered after login, and the 
directive file to be created is given the name 
DIRFIL. The directive file statements begin with 
the word SORT followed by a comma. The statements 
specify a user-defined collating sequence named 
MYSEQ. The first SEQS parameter specifies ten 
steps from to 9; the other SEQS parameter speci- 
fies one step consisting of hyp hens, blanks, and 
slashes. The SEQA parameter specifies that blanks 
and slashes are to be output as hyphens. The 
directive file is then reviewed (still using XEDIT) 
to make sure the file is accurate. The file DIRFIL 
is saved. as an indirect access permanent file. 

Under NOS/BE, EDITOR is entered after login. The 
statements of the directive file are identical to 
the statements entered under NOS, and the directive 
file is then reviewed using the LIST command. 
Using the SAVE command, DIRFIL is made a local file 
without sequence numbers; the CATALOG command saves 
the file as a permanent file. 

Figure 8-12 shows a portion of a NOS terminal ses- 
sion in which a file named NUMFIL (figure 8-13) is 
sorted according to the MYSEQ collating sequence. 
The directive file and the input file are assigned 
to the job with GET commands for indirect access 
permanent files. CRM FILE control statements are 
entered for the input and output files. 

The S0RT5 control statement is then entered naming 
the input and output files, the key field, and the 
directive file; the name of the user-defined 
collating sequence is the key type. After Sort/ 
Merge reads the directive file, an image of this 
file is printed or displayed at the terminal (the L 
parameter default is OUTPUT). When the sort is 
complete, the S0RT5 control statement is printed or 
displayed at the terminal (note that NOS repeats 
only 48 characters of the control statement). 
Control is then returned to the operating system. 

Figure 8-14 shows the output from the job using the 
directive file with the MYSEQ collating sequence. 
The records are in numeric order , and the separa- 
tors in the number have been standardized as 
hyphens in all records 



SUM PARAMETER USE 



Figure 8-10. Merged File NEWU 



Figure 8-15 shows the record layout in a file named 
GRADES. Each record includes three numeric fields: 
number of units attempted, number of units com- 
pleted, and grade points. Figure 8-16 shows file 
GRADES with multiple records for each student. 
Records are to be sorted according to student 
number and, using the SUM parameter, records with 
the same student number are to be combined into one 
record by adding together the numeric fields to 
give the total number of units attempted, units 
completed, and the total number of grade points. 
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NOS Operating System 

/xedit,di rf i l,c - 
XEDIT 3.1.00 

?? — 



INPUT — - 



? sort ,seqn=myseq 
? sort,seqs=( , 1 .. 
? sort,seqs=( '-', ' 
? sort ,seqa=yes 

? _- 



'9') 



/•>( 



EDIT — 

?? top ,*_ 
?? print* 



S0RT,S£QN=MYSE(i 

SORT^EttS^'O' ..'9') 

SORT^EUS^'-',' 

S0RT,SEQA=YES 

END OF FILE 

?? end,dirfi I, replace 

DIRFIL REPLACED 



NOS/BE Operating System 



/■)> — 



COMMAND- editor — 



. .1 s sort,seqn-myseq i 
2=sort,seqs=('0 , .. , 9 , > j 

3=sort,seqs=(•- , , , ','/')} 

4=sort,seqa=yes 

list, a, sup ^ 



S0RT,SEQN=MYSEQ 

SORT,SEQS=C0'. 

SORT^EI^C-',' ' 

SORT,SEQA=YES 

. . save,di rf i l,n -« 

..end -m 



9') 



/*)( 



COMMAND- cataloged irfi I, id=pubs — 



Enter XEDIT 1n create mode; DIRFIL is the name 
given the file to be created. 

Enter XEDIT input mode. 



Directive file statements. 



Enter XEDIT edit mode. 

Move pointer to the beginning of the file. 

Print the entire file. 



Directive file statements. 



Leave XEDIT and save DIRFIL as an indirect access 
permanent file. 



Enter EDITOR. 

Directive file statements. 

List the entire file. 

Directive file statements. 

Make edit file a local file without sequence numbers. 

Leave EDITOR. 

Save file as a permanent file named DIRFIL. 



Figure 8-11. Creating a Directive File 



/get,dirfil 

/get,numf i I 

/f ile(numf il,bt=c,rt=z,f 1=35) 

FILE(NUMFIL,BT=C,RT=Z,FL=35) 

/file<seqfil,bt=c,rt=z,fl=35> 

FILE(SEaFIL / BT=C,RT=Z,FL=35) 

/sort5.from=numfi l,to=seqf i l,key=( (25,11 ,myseq) > ,di r=di rf i I 

1 

SORT/MERGE 5.0 * LISTING OF DIRECTIVE FILE - DIRFIL 
12/04. 16.45.45. 

1. SORT,SEQN=MYSEQ 

2. S0RT,SE«S=< , , ..'9') 

3. SORT^ECS^'-',' ','/') 

4. SORT,SEaA=YES 



SORT/MERGE 5 - 



18 RECORDS SORTED 



Figure 8-12. Using a Directive File (NOS) 
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Figure 8-13, File NUMFIL 
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Figure 8-14. Output From Sort Using a Directive File 



Figure 8-16. File GRADES 
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Figure 8-15. File GRADES Record Layout 
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Figure 8-17 shows the S0RT5 control statement with 
the SUM parameter. The Input and output files are 
named, and the student number (character positions 
15 through 20) is specified as the sort key. The 
SUM parameter specifies that a 3-character numeric 
field of type NUMERICJSS begins in position 36 in 
each record. The repetition indicator 3 specifies 
that three contiguous fields are to be summed. 
Figure 8-18 shows the output from the job. The 
output file contains one record for each student. 
The numeric fields are the totals of the units 
attempted, units completed, and grade points. 



A SORT USING PROCEDURE CALLS 

Figure 8-19 shows the job structures for performing 
a sort from within a FORTRAN program. Under both 
NOS and NOS/BE, the job statements and accounting 
information are followed by ATTACH commands to 
assign the input data file (UNIVER) and the file 
containing the FORTRAN source program to the job. 
The FORTRAN 5 compiler is called, and the program 
is compiled. The program is then executed (LGO). 

Figure 8-20 shows the FORTRAN program containing 
the Sort/Merge procedure calls. File UNIVER is 
read, and student records with grade point average 



of 3.50 or better are written to an intermediate 
file (INT1). Sort/Merge is. called to sort the file 
on grade point average in descending order (highest 
grade point average to lowest grade point aver- 
age). The SM5SORT call names a result array that 
is dimensioned as a 16-element integer array and 
the first element set to 15 to receive the maximum 
number of sort results and statistics. 

The SM50WN1 call specifies that an owncode 1 
routine named CCODE is to be executed after Sort/ 
Merge reads each record from INT1. Records are 
passed to the routine by Sort/Merge. Figure 8-21 
shows the routine, which is a FORTRAN subroutine. 
The SUBROUTINE statement names the routine and the 
parameters passed by Sort/Merge. Parameter RETCODE 
is the return_code passed as 0, REC is an array 
containing the record, and RL is the record length 
in characters. The routine converts the class code 
in each record to the class name. The records are 
returned to Sort/Merge in array REC. The 
return_code value is left as because each record 
in this example is to be sorted. Sort/Merge then 
sorts the records to file INT2. The sorted file is 
returned to the FORTRAN program to be written out 
in a formatted report. Figure 8-22 shows the 
output from the job, which includes the report and 
the contents of the result array. 



/get, grades 

/f i le(grades,bt = c,rt = z,f 1=44) 

FILE (GRADES, BT=C,RT=Z,FL=44> 

/f i le(sumex,bt=c,rt=z,f L=44) 

FILECSUNEX,BT=C,RT=Z,FL=44) 

/sortS.f rom=grades,to=sumex,key=15. .20,sum=( C36,3,numer 1 c ns,3)) 

SORT/MERGE 5 - 47 RECORDS SORTED 
/ 



Figure 8-17. Interactive Parameter Specification for SUM Example 
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Figure 8-18. Output From SUM Example 
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NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH.UNIVER.SM5EX. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FTN5,l=SM5EX,L=OUTEX. 

LGO. 

COPY,OUTEX,OUTPUT. 

EOI 



NOS/BE Operating System 

Job statement 

A CCO UNT statement 

ATTACH,UNIVER,lb=PUBS. 

ATTACH.SM5EX.ID=F. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FTN5,l=SM5EX,L=OUTEX. 

LGO. 

COPY,OUTEX,OUTPUT. 

EOI 



Figure 8-19. Job Structure for Sort Called From a FORTRAN Program 



1 PROGRAM DLIST 

2 INTEGER GPA 

3 CHARACTER SNAME*14, MAJ0R*8, C0DE*1, CLASS*12 

4 DIMENSION IARAYC16) 

5 COMMON /COMN/ CODE, CLASS 

6 EXTERNAL CCODE 

7 C 

8 1 READ(L"UNIVER",100,END=10> SNAME, MAJOR, GPA, CODE 

9 IF (GPA .GE. 350) WRITECL" INT1",200> SNAME, MAJOR, GPA, CODE 

10 GO TO 1 

11 C 

12 10 IARAYC1>=15 

13 CALL SM5SORT<IARAY) 

14 CALL SM50FLC80) 

15 CALL SMSFROMCINTI') 

16 CALL SM5KEY<33,3,'ASCII6 , ,'D') 

17 CALL SM5OWNKCCO0E) 

18 CALL SM5T0< , INT2•) 

19 CALL SM5END 

20 REWIND(L"INT2"> 

21 C 

22 PRINT *, IARAY 

23 WRITE(L"OUTEX",400> 

24 15 READCL ,, INT2",300,END=20> SNAME, MAJOR, GPA, CLASS 

25 WR1TE(L"0UTEX",500> SNAME, MAJOR, CLASS, GPA 

26 GO TO 15 

27 C 

28 100 FORMAT < A14,12X,A8,I3,A1> 

29 200 FORMAT CA14,5X, A8,5X,I3,5X,A1 ,39X> 

30 300 FORMAT CA14,5X,A8,5X, I3,5X,A12,28X) 

31 400 FORMAT C36X, "DEAN'S LIST" // 1 5X, "STUDENT", 

32 * 12X, "MAJOR", 8X, "CLASS", 12X, "GPA", 65X /) 

33 500 FORMAT (1 5X, A14, 5X,A8,5X, A12, 5X, I3,59X> 

34 C 

35 20 STOP 

36 END 



Figure 8-20. FORTRAN Program With Sort/Merge Procedure Calls 
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SUBROUTINE CCODE (RETCODE,REC, RL> 
INTEGER RETCODE, RL 

CHARACTER C1*6, C2*6, C3*9, C4*3, C5*12, 
* C0DE*1, CLASS*12, REC(*)*12 

COMMON /SUBCOM/ CODE, CLASS 
DATA C1,C2/'SENI0R',' JUNIOR'/ 
DATA C3,C4/' SOPHOMORE ',' FRESHMAN'/ 
DATA C5/MJNCLASSIFIED' / 

CODE = REC(4) C5:5) 

IF (CODE .EQ. '1 ') THEN 

CLASS = C1 
ELSE IF (CODE 

CLASS = C2 
ELSE IF (CODE 

CLASS = C3 
ELSE IF (CODE 

CLASS = C4 
ELSE IF (CODE 

CLASS = C5 
ELSE 

PRINT *, CODE 
END IF 

REC(4)(5:12) = CLASS(1:8) 
REC(5)(1:4) = CLASS(9:12) 
RETURN 
END 



EQ. 


'2 


) 


THEN 


EQ. 


•3 


) 


THEN 


EQ. 


'4 


) 


THEN 


EQ. 


•5 


) 


THEN 



Figure 8-21. Owncode Routine 



A. Report 






DEAN'S 


LIST 




STUDENT 






MAJOR 


CLASS 


GPA 


SHIELDS 


L 


E 


COMPSCI 


SENIOR 


390 


HORNE 


D 


N 


COMPSCI 


FRESHMAN 


389 


TERRELL 


T 


H 


EN6 


SENIOR 


386 


SMITH 


F 


R 


PHIL 


SOPHOMORE 


385 


SMITH 


C 


R 


MATH 


SENIOR 


379 


CLARK 


D 


N 


ECON 


JUNIOR 


378 


TIEMON 


H 


R 


LNGUIS 


SOPHOMORE 


376 


FRANKLIN 


R 


H 


PHIL 


JUNIOR 


370 


HANSEN 


R 


P 


BUS 


SOPHOMORE 


358 


DAVIS 


D 


A 


ENG 


SENIOR 


354 


SUGARMAN 


8 


T 


SOC 


SENIOR 


350 



B. Result Array 

15 11 11 11 80 80 80 

Element 1; 

user set. Elements 2 thru 16; set by 

Sort/Merge. See table 5-1. 



Figure 8-22. Output From FORTRAN Program 
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CHARACTER DATA INPUT, OUTPUT, AND, 
CENTRAL MEMORY REPRESENTATION 



This appendix describes the code and character sets 
used by host computer operating system local batch 
device drivers, magnetic tape drivers, and terminal 
communication products. Some software products 
assume that certain graphic or control characters 
are associated with specific binary code values for 
collating or syntax processing purposes. This 
appendix does not describe those associations. 

All references within this manual to the ASCII 
character set or the ASCII code set refer to the 
character set and code set defined in the American 
National Standard Code for Information Interchange 
(ASCII, ANSI Standard X3. 4-1977). References in 
this manual to the ASCII character set do not 
necessarily apply to the ASCII code set. Sort/ 
Merge uses a 63- or 64-character subset of the full 
ASCII set. Only characters in 6-bit or internal 
BCD display code should be used with Sort/Merge. 

CHARACTER SETS AND CODE SETS 

A character set differs from a code set. A char- 
acter set is a set of graphic and/or control char- 
acters. A code set is a system of symbols used to 
represent each character within a character set. 
Characters exist outside the computer system and 
communication network; codes are received, stored, 
retrieved, and transmitted within the computer 
system and network. 

GRAPHIC AND CONTROL 
CHARACTERS 

A graphic character can be displayed at a terminal 
or printed by a line printer. Examples of graphic 
characters are the characters A through Z, a blank, 
and the digits through 9. A control character 
initiates, modifies, or stops a control operation. 
An example of a control character is the backspace 
character, which moves the terminal carriage or 
cursor back one space. Although a control char- 
acter is not a graphic character, some terminals 
can produce a graphic representation when they 
receive a control character. 

CODED AND BINARY 
CHARACTER DATA 

Character codes can be interpreted as coded char- 
acter data or as binary character data. Coded 
character data is converted from one code set 
representation to another as it enters or leaves 
the computer system; for example, data received 
from a terminal or sent to a magnetic tape unit is 
converted. Binary character data is not converted 
as it enters or leaves the system. Character codes 
are not converted when moved within the system; for 
example, data transferred to or from mass storage 
is not converted. 

The distinction between coded character data and 
binary character data is important when reading or 



punching cards and when reading or writing magnetic 
tape. Only coded character data can be properly 
reproduced as characters on a line printer. Only 
binary character data can properly represent char- 
acters on a punched card when the data cannot be 
stored as display code. 

The distinction between binary character data and 
characters represented by binary data (such as 
peripheral equipment instruction codes) is also 
important. Only such binary noncharacter data can 
properly reproduce characters on a plotter. 



FORMATTED AND UNFORMATTED 
CHARACTER DATA 

Character codes can be interpreted by a product as 
formatted character data or as unformatted char- 
acter data. Formatted data can be stored or 
retrieved by a product in the form of the codes 
described for coded character data in the remainder 
of this appendix, or formatted data can be altered 
to another form during storage or retrieval; for 
example, 1 can be stored as a character code or as 
an integer value. Treatment of unformatted data by 
a product includes both coded character data and 
binary character data as described in this appendix. 

NETWORK OPERATING SYSTEMS 

The NOS and NOS/BE operating systems support the 
following character sets: 

• CDC graphic 64-character set 

• CDC graphic 63-character set 

• ASCII graphic 64-character set 

• ASCII graphic 63-character set 

• ASCII graphic 95-character set 

In addition, NOS supports the ASCII 128-character 
graphic and control set. 

Each installation must select either a 64-character 
set or a 63-character set. The differences between 
the codes of a 63-character set and the codes of a 
64-character set are described under Character Set 
Anomalies. Any reference in this appendix to a 64- 
character set implies either a 63- or 64-character 
set unless otherwise stated. 

To represent its six listed character sets in 
central memory, NOS supports the following code 
sets: 

• 6-bit display code 

• 12-bit ASCII code 

• 6/12-bit display code 
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To represent its five listed character sets in 
central memory, NOS/BE supports the following code 
sets: 

• 6-bit display code 

• 12-bit ASCII code 

Under both NOS and NOS/BE, the 6-bit display code 
is a set of 6-bit codes from 00g to 77s . 

Under both NOS and NOS/BE, the 12-bit ASCII code is 
the ASCII 7-bit code (as defined by ANSI Standard 
X3. 4-1977) right-justified in a 12-bit byte. 
Assuming that the bits are numbered from the right 
starting with 0, bits through 6 contain the ASCII 
code, bits 7 through 10 contain zeros, and bit 11 

distinguishes the 1 2-bit ASCII OOOOg co de from 

the end-of-line byte. The 12-bit codes are OOOlg 
through 0177 8 and 4000 8 . 

Under NOS, the 6/12-bit display code is a combina- 
tion of 6-bit codes and 12-bit codes. The 6-bit 
codes are 00g through 77 8 , excluding 74s and 
76g. (The interpretation of the OOg and 63s 
codes is described under Character Set Anomalies in 
this appendix.) The 12-bit codes begin with either 
74g or 768 and are followed by a 6-bit code. 
Thus, 74g and 76g are considered escape codes 
and are never used as 6-bit codes within the 
6/12-bit display code set. The 12-bit codes are 
7401 8 , 7402 8 , 7404 8 , 7407 8 , and 7601 8 
through 7677 8 . All other 12-bit codes (74xx 8 
and 7600g) are undefined. 



CHARACTER SET ANOMALIES 

The operating system input/output software and some 
products interpret two codes differently when the 
installation selects a 63-character set rather than 
a 64-character set. If an installation uses a 
63-character set, the colon graphic character is 
always represented by a 63 8 display code, display 
code OOg is undefined (it has no associated 
graphic or punched card code) , and the % graphic 
does not exist. 

However, under NOS, if the installation uses a 
64-character set, output of a 7404g 6/12-bit 
display code or a OOg display code produces a 
colon. A colon can be input only as a 7404 8 
6/12-bit display code. The use of undefined 
6/12-bit display codes in output files produces 
unpredictable results and should be avoided. 

Under NOS/BE, if the installation uses a 64- 
character set, output of a OOg display code 
produces a colon. Display code 63g is the colon 
when a 63-character set is used. The % graphic and 
related card codes do not exist and translations 
yield a blank (55g). 

Under both NOS and NOS/BE, two consecutive 00 8 
codes can be confused with an end-of-line byte and 
should be avoided. 



CHARACTER SET TABLES 

The character set tables A-l and A-2 are designed 
so that you can find the character represented by a 
code (such as in a dump) or find the code that 



represents a character. To find the character 
represented by a code, look up the code in the 
column listing the appropriate code set and then 
find the character on that line in the column 
listing the appropriate character set. To find the 
code that represents a character, look up the 
character and then find the code on the same line 
in the appropriate column. 



Conversational Terminal Users 

Table A-l shows the character sets and code sets 
available to an Interactive Facility (IAF) or 
INTERCOM user at an ASCII code terminal using an 
ASCII character set. The Full ASCII Character Set 
table (later in ....this appendix) shows the octal and 
hexadecimal 7-bit ASCII code for each ASCII char- 
acter, and can be used to convert codes from octal 
to hexadecimal. (Under NOS using network product 
software, certain Terminal Interface Program com- 
mands require specification of an ASCII code. 



IAF Usage 

When in normal time-sharing mode (specified by the 
IAF NORMAL command), IAF assumes the ASCII graphic 
64-character set is used and translates all input 
and output to or from display code. When in ASCII 
time-sharing mode (specified by the IAF ASCII 
command), IAF assumes the ASCII 128-character set 
is used and translates all input and output to or 
from 6/12-bit display code. 

The IAF user can convert a 6/12-bit code file to a 
12-bit ASCII code file using the NOS FCOPY control 
statement. The resulting 12-bit ASCII file can be 
routed to a line printer but cannot be output 
through IAF. 

IAF supports both character mode and transparent 
mode transmissions through the network. These 
transmission modes are described under Network 
Access Method Terminal Transmission Code Sets in 
this appendix. IAF treats character mode trans- 
missions as coded character data; IAF converts 
these transmissions to or from either 6-bit or 
6/12-bit display code. IAF treats transparent mode 
transmissions as binary character data; transparent 
mode communication between IAF and ASCII terminals 
using any parity setting occurs in the 12-bit ASCII 
code shown in table A-l. 



INTERCOM Usage 

By default, INTERCOM displays the ASCII graphic 
64-character set and interprets all input and 
output as display code. Refer to the INTERCOM 
reference manual. 

COMPASS and FORTRAN users can elect to use 12-bit 
ASCII code if the terminal in use supports the code 
set selected. BASIC users can elect to send and 
receive lowercase and uppercase character codes 
using the 12-bit ASCII code if the terminal in use 
supports the code set selected; BASIC represents 
coded character data in central memory using 
6/12-bit display code in both the NOS and NOS/BE 
systems. 



A-2 
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TABLE A-l. CONVERSATIONAL TERMINAL CHARACTER SETS 



ASCII 

Graphic 

(64-Char- 

acter Set) 



,tt 



: colon 

A 

B 

C 

D 

E 

F 

6 

H 

I 

J 

K 

L 

M 

N 



P 

Q 

R 

S 

T 

U 

V 

u 

X 
Y 

z 


1 

2 

3 

4 

5 

6 

7 

8 

9 

+ plus 

- minus 

* asterisk 

/ slash 

( I. paren. 



ASCII 
Character 
(128-Char- 
acter Set) 



) r. paren. 
$ dollar 
- equal to 

space 
s comma 
. period 
# number 
r I. bracket 
"i r. bracket 
X percent** 
" quote 
_ underline 
! exclam. 
8 ampersand 
' apostrophe 
? question 
< less than 
> grtr. than 
3 coml. at 
V rev. slant 
•*■ circumflex 
; semicolon 



A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 

n 

N 

o 

p 
a 

R 

s 

T 
U 
V 

w 

X 
Y 
Z 


1 
2 
3 

4 

5 

6 

7 

8 

9 

+ plus 

- minus 

* asterisk 
/ slash 

( I. paren. 
) r. paren. 
$ dollar 
= equal to 

space 
t comma 
. period 

# number 

r l. bracket 
3 r. bracket 



percent 



tt 



" quote 
_ underline 

! exclam. 

& ampersand 

' apostrophe 

? question 

< less than 

> grtr. than 

\ rev. slant 

; semicolon 

a coml. at 



Octal 

6-Bit 

Display 

Code 



00" 

01 

02 

03 

04 

05 

06 

07 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

50 

51 

52 

53 

54 

55 

56 

57 

60 

61 

62 

63" 

64 

65 

66 

67 

70 

71 

72 

73 

74 

75 

76 

77 



Octal 
6/12-Bit 
Display 

Code* 



01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

50 

51 

52 

53 

54 

55 

56 

57 

60 

61 

62 

63" 

64 

65 

66 

67 

70 

71 

72 

73 

75 



77 
7401 



Octal 
12-Bit 
ASCII 
Code 



0101 

0102 

0103 

0104 

0105 

0106 

0107 

0110 

0111 

0112 

0113 

0114 

0115 

0116 

0117 

0120 

0121 

0122 

0123 

0124 

0125 

0126 

0127 

0130 

0131 

0132 

0060 

0061 

0062 

0063 

0064 

0065 

0066 

0067 

0070 

0071 

0053 

0055 

0052 

0057 

0050 

0051 

0044 

0075 

0040 

0054 

0056 

0043 

0133 

0135 

0045 

0042 

0137 

0041 

0046 

0047 

0077 

0074 

0076 

0134 

0073 
0100 



ASCII 

Graphic 

(64-Char- 

acter Set) 



ASCII 
Character 
(128-Char- 
acter Set) 



"*■ circumflex 

: colon" 

' grave accent 

a 
b 
c 
d 

e 
f 

g 

h 
i 

i 
k 

I 

ID 

n 
o 
P 
q 

r 
s 

t 
u 

V 

w 

X 

y 

z 

•C left brace 

| vert, line 

> right brace 

" tilde 

NUL 

S0H 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 

HT 

LF 

VT 

FF 

CR 

SO 

SI 

DEL 

DLE 

DC1 

DC2 

DC3 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 

SUB 

ESC 

FS 

GS 

RS 

US 



Octal 

6-Bit 

Display 

Code 



Octal 
6/12-Bit 
Display 

Code* 



Octal 
12-Bit 
ASCII 
Code 



7402 


0136 


7404" 


0072 


7407 


0140 


7601 


0141 


7602 


0142 


7603 


0143 


7604 


0144 


7605 


0145 


7606 


0146 


7607 


1047 


7610 


0150 


7611 


0151 


7612 


0152 


7613 


0153 


7614 


0154 


7615 


0155 


7616 


0156 


7617 


0157 


7620 


0160 


7621 


0161 


7622 


0162 


7623 


0163 


7624 


0164 


7625 


0165 


7626 


0166 


7627 


0167 


7630 


0170 


7631 


0171 


7632 


0172 


7633 


0173 


7634 


0174 


7635 


0175 


7636 


0176 


7640 


4000 


7641 


0001 


7642 


0002 


7643 


0003 


7644 


0004 


7645 


0005 


7646 


0006 


7647 


0007 


7650 


0010 


7651 


0011 


7652 


0012 


7653 


0013 


7654 


0014 


7655 


0015 


7656 


0016 


7657 


0017 


7637 


0177 


7660 


0020 


7661 


0021 


7662 


0022 


7663 


0023 


7664 


0024 


7665 


0025 


7666 


0026 


7667 


0027 


7670 


0030 


7671 


0031 


7672 


0032 


7673 


0033 


7674 


0034 


7675 


0035 


7676 


0036 


7677 


0037 



Generally available only on NOS, or through BASIC on NOS/BE. 



tt 



The interpretation of this character or code depends on its context. Refer to Character Set Anomalies in 
the text. 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS 



CDC 

Graphic 

(64-Character 

Set) 



ASCII 

Graphic 

(64-Character 

Set) 



ASCII 

Graphic 

(95-Character 

Set) 



Octal 

6-Bit 

Display 

Code 



Octal 
6/12-Bit 
Display 
Code* 



Octal 
12-Bit 
ASCII 
Code 



Card Keypunch Code 



026 



029 



colon 1 " 1 " 



A 
B 
C 
D 
E 
F 
G 

H 
I 
J 
K 
L 
M 
N 


P 
9 
R 
S 

T 
U 
V 

u 

X 
Y 

z 


1 

2 
3 

4 

5 
6 

7 

8 

9 

+ plus 

- minus 

* asterisk 

/ slash 

( left paren. 

) right paren. 

$ dollar 

= equal to 

space 
z comma 
. period 

= equivalence 
C left bracket 

1 right bracket 
% percent 1 " 1 " 



Hon 11 



A 
B 
C 
D 
E 
F 
G 

H 

I 
J 
K 
L 
M 
N 


P 
Q 
R 
S 

T 
U 
V 

u 

X 
Y 

z 


1 

2 
3 
4 

5 
6 

7 
8 
9 

+ 



plus 
- minus 

* asterisk 

/ slash 

( left paren. 

) right paren. 

$ dollar 

= equal to 

space 
z comma 
. period 

# number 

C left bracket 

3 right bracket 
X percent 11 



A 
B 
C 
D 

E 
F 
G 

H 
I 
J 

K 

L 

n 

N 

o 
p 

Q 
R 
S 

T 
U 
V 

u 

X 
Y 

z 


1 

2 
3 
4 

5 

6 

7 

8 

9 

+ plus 

- minus 

* asterisk 

/ slash 

( left paren. 

) right parens 

$ dollar 

= equal to 

space 
, comma 
. period 

H number 

C I. bracket 

] r. bracket 

% percent 1 " 1 



00 tt 

01 

02 

03 

04 

05 

06 

07 

10 
11 
12 
13 
14 
15 
16 
17 

20 
21 
22 
23 
24 
25 
26 
27 

30 
31 
32 
33 
34 
35 
36 
37 

40 
41 
42 
43 
44 
45 
46 
47 

50 
51 
52 
53 
54 
55 
56 
57 

60 

61 

62 

63 11 



01 
02 
03 
04 
05 
06 
07 

10 
11 
12 
13 
14 
15 
16 
17 

20 
21 
22 
23 
24 
25 
26 
27 

30 
31 
32 
33 
34 
35 
36 
37 

40 
41 
42 
43 
44 
45 
46 
47 

50 
51 
52 
53 
54 
55 
56 
57 

60 
61 

62 

63tt 



0101 
0102 
0103 
0104 
0105 
0106 
0107 



0110 
0111 
0112 
0113 
0114 
0115 
0116 
0117 

0120 
0121 
0122 
0123 
0124 
0125 
0126 
0127 

0130 
0131 
0132 
0060 
0061 
0062 
0063 
0064 

0065 
0066 
0067 
0070 
0071 
0053 
0055 
0052 

0057 
0050 
0051 
0044 
0075 
0040 
0054 
0056 

0043 
0133 

0135 
0045 



8-2 
12-1 
12-2 
12-3 
12-4 
12-5 
12-6 
12-7 

12-8 
12-9 
11-1 
11-2 
11-3 
11-4 
11-5 
11-6 

11-7 
11-8 
11-9 
0-2 
0-3 
0-4 
0-5 
0-6 

0-7 
0-8 
0-9 

1 
2 
3 
4 

5 

6 

7 

8 

9 

12 

11 

11-8-4 

0-1 

0-8-4 

12-8-4 

11-8-3 

8-3 

no punch 

0-8-3 

12-8-3 

0-8-6 
8-7 

0-8-2 

8-6 



8-2 
12-1 
12-2 
12-3 
12-4 
12-5 
12-6 
12-7 

12-8 

12-9 
11-1 
11-2 
11-3 
11-4 
11-5 
11-6 

11-7 
11-8 
11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 
0-8 
0-9 



1 

2 

3 

4 

5 

6 

7 

8 

9 

12-8-6 

11 

11-8-4 

0-1 

12-8-5 

11-8-5 

11-8-3 

8-6 

no punch 

0-8-3 

12-8-3 

8-3 

12-8-2 t 
or 12-0 m 

11-8-2 

or 11-0 nt 

0-8-4 



A-4 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS (Contd) 



CDC 

Graphic 

(64-Character 

Set) 



* not equal 
r*concat. 



V logical OR 



A logical AND 
t superscript 
subscript 
less than 
greater than 
_ less/equal 
> greater/equal 
-i logical NOT 



ASCII 
Graphic 
(64-Character 
Set) 



semicolon 



quote 
underline 



! exclamation 



S ampersand 
" apostrophe 
question 
less than 
greater than 
commercial at 
reverse slant 
circumflex 



semicolon 



ASCII 
Graphic 
(95-Character 
Set) 



" quote 
underline 



! exclamation 



S ampersand 
' apostrophe 
? question 
< less than 
> greater than 

\ rev. slant 



; semicolon 

9 com I. at 

■*■ circumflex 

: colon 

' grave accent 

a 

b 

c 

d 
e 
f 
9 
h 
i 
J 

k 

I 
■ 
n 
o 
P 
q 
r 

s 
t 
u 

V 

w 

X 

y 

z 

■C left brace 
| vert, line 
> right brace 
" tilde 



Octal 

6-Bit 

Display 

Code 



64 
65 



66 



67 
70 
71 
72 
73 
74 
75 
76 

77 



Octal 
6/12-Bit 
Display 

Code 1 



64 
65 



66 



67 
70 
71 
72 
73 

75 



77 
7401 
7402 
7404 
7407 
7601 
7602 

7603 
7604 
7605 
7606 
7607 
7610 
7611 
7612 

7613 
7614 
7615 
7616 
7617 
7620 
7621 
7622 

7623 
7624 
7625 
7626 
7627 
7630 
7631 
7632 

7633 
7634 
7635 
7636 



Octal 
12-Bit 
ASCII 
Code 



0042 
0137 



0041 



0046 
0047 
0077 
0074 
0076 

0134 



0073 
0100 
0136 
0072 
0140 
0141 
0142 

0143 
0144 
0145 
0146 
0147 
0150 
0151 
0152 

0153 
0154 
0155 
0156 
0157 
0160 
0161 
0162 

0163 
0164 
0165 
0166 
0167 
0170 
0171 
0172 

0173 
0174 
0175 
0176 



Card Keypunch Code 



026 



12-8-7 



029 



8-4 


8_7 R 


0-8-5 


0-8-5§ 




or 




11-0 


11-0§ 


12-8-7 


or 




11-8-2 




0-8-7 


12 


11-8-5 


8-5 


11-8-6 


0-8-7 


12-0 


12-8-4 


11-8-7 


0-8-6 


8-5 


8-4 


12-8-5 


0-8-2 


12-8-6 


11-8-7 



11-8-6 



Generally available only on NOS, or through BASIC on NOS/BE. 

"The interpretation of this character or code depends on its context. Refer to Character Set Anomalies 
in the text. 

m Available for input only, on NOS. 

§ Available for input only, on NOS/BE. 
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Local Batch Users 

Table A-2 lists the CDC graphic 64-character set, 
the ASCII graphic 64-character set, and the ASCII 
graphic 95-character set. This table also lists 
the code sets and card keypunch codes (026 and 029) 
that represent the characters. 

The 64-character sets use display code as their 
code set; the 95-character set uses 12-bit ASCII 
code. The 95-character set is composed of all the 
characters in the ASCII 128-character set that can 
be printed at a line printer (refer to Line Printer 
Output). Only 12-bit ASCII code files can be 
printed using the ASCII graphic 95-character set. 
To print a 6/12-bit display code file (usually 
created in IAF ASCII mode), you must convert the 
file Jo 12-bit ASCII code. To do this, the NOS 
FCOPY control statement must be issued. The 
95-character set is represented by the 12-bit ASCII 
codes 0040g through 01763. 



Depending on an installation or deadstart option, 
NOS assumes an input deck • has been punched either 
in 026 or 029 keypunch code (regardless of the 
character set in use). The alternate keypunch 
codes can be specified by a 26 or 29 punched in 
columns 79 and 80 of any job card, 6/7/9 card, or 
7/8/9 card. The specified code translation remains- 
in effect throughout the job unless it is reset by 
specification of the alternate code translation on 
a subsequent 6/7/9 card or 7/8/9 card. 

NOS keypunch code translation can also be changed 
by a card containing a 5/7/9 punch in column 1. A 
blank (no punch) in column 2 indicates 026 conver- 
sion mode; a 9 punch in column 2 indicates 029 
conversion mode. The conversion change remains in 
effect until another change card is encountered or 
the job ends. 

The 5/7/9 card also allows literal input when 
4/5/6/7/8/9 is punched in column 2. Literal input 
can be used to read 80-column binary character data 
within a punched card deck of coded character data. 



Line Printer Output 

The batch character set printed depends on the 
print train used on the line printer to which the 
file is sent. The following are the print trains 
corresponding to each of the batch character sets: 



Character Set 



CDC graphic 64-character set 
ASCII graphic 64-character set 
ASCII graphic 95-character set 



Print 
Train 

596-1 

596-5 

596-6 



The characters of the default 596-1 print train are 
listed in the table A-2 column labeled CDC Graphic 
(64-Character); the 596-5 print train characters 
are listed in the table A-2 column labeled ASCII 
Graphic (64-Character); and the 596-6 print train 
characters are listed in the table A-2 column 
labeled ASCII Graphic (95-Character). 

If a transmission error occurs during the printing 
of a line, NOS prints the line again. The CDC 
graphic print train prints a concatenation symbol 
( ("" *) in the first printable column of a line 
containing errors. The ASCII print trains print an 
underline instead of the concatenation symbol. 

If an unprintable character exists in a line (that 
is, a 12-bit ASCII code outside of the range 
0040g through 0176g), the number sign (#) 
appears in the first printable column of a print 
line and a space replaces the unprintable character. 



Punched Card Input and Output 

Under NOS, coded character data is exchanged with 
local batch card readers or card punches according 
to the translations shown in table A-2. As indi- 
cated in the table, additional card keypunch codes 
are available for input of the ASCII and CDC char- 
acters [ and ] . The 95-character set cannot be 
read or punched as coded character data. 



Literal cards are stored with each column in a 
12-bit byte (a row 12 punch is represented by a 1 
in bit 11, row 11 by bit 10, row by bit 9, and 
rows 1 through 9 by bits 8 through of the byte), 
16 central memory words per card. Literal input 
cards are read until a card identical to the pre- 
vious 5/7/9 card (4/5/6/7/8/9 in column 2) is 
read. The next card can specify a new conversion 
mode. 

Under NOS/BE, coded character data is exchanged 
with local batch card readers or card punches 
according to the translations shown in table A-2. 
As indicated in the table, additional card keypunch 
codes are available for input of the CDC characters 
V and < or their ASCII equivalents ! and <• The 
95-character set cannot be read or punched as coded 
character data. 

Depending on an installation option, NOS/BE assumes 
an input deck has been punched either in 026 or in 
029 keypunch code (regardless of the character set 
in use). The alternate keypunch codes can be 
specified by a 26 or 29 punched in columns 79 and 
80 of the job statement or in columns 79 and 80 of 
any 7/8/9 card. The specified code translation 
remains in effect throughout the job unless it is 
reset by specification of the alternate code 
translation on a subsequent 7/8/9 card. 

Under NOS/BE, a card with all of column 1 punched 
(that is, 12 punches in column 1) and all of one 
other column punched can be followed by 80-column 
cards of free-form binary data. These binary data 
cards are read or punched as described for NOS 
literal data until another card with 12 punches in 
column 1 and in one other column occurs, or until 
the job ends. The next card is interpreted as 
coded data. 



Remote Batch Users 

When card decks are read from remote batch devices, 
the ability to select alternate keypunch code 
translations depends upon the remote terminal 
equipment. 
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NOS Usage 

Remote batch terminal line printer, punched card, 
and plotter character set support is described in 
the Remote Batch Facility (RBF) reference manual. 
RBF supports only character mode transmission to 
and from consoles through the network. Character 
mode is described under Network Access Method 
Terminal Transmission Code Sets in this appendix. 



NOS/BE Usage 

The remote batch terminal line printer, punched 
card, and plotter character set support is de- 
scribed in the INTERCOM reference manual. 



Magnetic Tape Users 

Coded character data to be copied from mass storage 
to magnetic tape is assumed to be represented in 
display code. NOS converts the data to external 
BCD code when writing a coded 7-track tape and to 
ASCII or EBCDIC code (as specified on the tape 
assignment statement) when writing a coded 9-track 
tape. 

Because only 63 characters can be represented in 
7-track even parity, one of the 64 display codes is 
lost in conversion to and from external BCD code. 
Figure A-l shows the differences in conversion that 
depend on which character set (63 or 64) the system 
uses. The ASCII character for the specified char- 
acter code is shown in parentheses. The output 
arrow shows how the display code changes when it is 
written on tape in external BCD. The input arrow 
shows how the external BCD code changes when the 
tape is read and converted to display code. 





63-Character Set 




Display Code 


External BCD 

16(%) 

Output 12(0) 

" 12(0) 


Display Code 


00 

33(0) 

63<:) 


00 
Input 33(0) 
33(0) 




64-Character Set 




Display Code 


External BCD 

12(0) 

Output 12(0) 

16(%) 


Display Code 


00(:) 
33(0) 

63(%) 


33(0) 

Input 33(0) 

63(%) 



Figure A-1. Magnetic Tape Code Conversions 

Tables A-3 and A-4 show the character set conver- 
sions for 9-track tapes. Table A-3 lists the 
conversions to and from 7-bit ASCII character code 
and 6-bit display code. Table A-4 lists the 
conversions between 8-bit EBCDIC character code and 
6-bit display code. Table A-5 shows the character 
set conversions between 6-bit external BCD and 
6-bit display code for 7-track tapes. 

If a lowercase ASCII or EBCDIC code is read from a 
9-track coded tape, it is converted to its upper- 
case 6-bit display code equivalent. To read and 
write lowercase ASCII or EBCDIC characters, the 



user must assign the tape in binary mode and then 
convert the binary character, data. 

During binary character data transfers to or from 
9-track magnetic tape, the 7-bit ASCII codes shown 
in table A-6 are read or written unchanged; the 
8-bit hexadecimal EBCDIC codes shown in table A-7 
also can be read or written unchanged. ASCII and 
EBCDIC codes cannot be read or written to 7-track 
magnetic tape as binary character data. 

Two CDC utility products, FORM and the 8-Bit Sub- 
routines, can be used to convert to and from EBCDIC 
data. Table A-7 contains the octal values of each 
EBCDIC code right- justified in a 12-bit byte with 
zero fill. This 12-bit EBCDIC code can also be 
produced using FORM and the 8-Bit Subroutines. 

NETWORK ACCESS METHOD TERMINAL 
TRANSMISSION CODE SETS 

There are two modes in which coded character data 
can be exchanged with a network terminal console. 
These two modes, character mode and transparent 
mode, correspond to the type of character code 
editing and translation performed by the network 
software during input and output operations. The 
transmission mode used by the network software for 
input can be selected by the terminal operator, 
using a Terminal Interface Program command 
(sometimes referred to as a terminal definition 
command). The transmission mode used by the 
network software for output can be selected by the 
application program providing the terminal facility 
service. 



Character Mode Transmissions 

Character mode is the initial and default mode used 
for both input and output transmissions. When the 
network software services the terminal in character 
mode, it translates input characters from the 
transmission code used by the terminal into the 
ASCII code shown in table A-6. The translation of 
a specific transmission code to a specific ASCII 
code depends on the terminal class the network 
software associates with the terminal. In char- 
acter mode input, the parity of the terminal 
transmission code is not preserved in the corres- 
ponding ASCII code; the ASCII code received by the 
terminal-servicing facility program always has its 
eighth bit set to zero. 

Character mode output is translated in a similar 
manner. The network software provides the parity 
bit setting appropriate for the terminal being 
serviced, even though translating from ASCII char- 
acters with zero parity bit settings. 

The general case for code translations of character 
mode data is summarized in the following para- 
graphs. This generalized description permits use 
of only table A-6 to explain all specific cases. 
You can logically extend this generalized descrip- 
tion to allow use of tables A-l through A-5 as 
descriptions of character set mapping for various 
functions initiated from a terminal. Tables A-l 
through A-5 are provided for your use while coding 
an application program to run under the operating 
system. They do not describe character trans- 
missions between an application program and the 
network. 
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TABLE A-3. ASCII 9-TRACK CODED TAPE CONVERSION 



ASCII 




ASCII 


Display 






Display 






Code 


Character and 


Code*** 


Code 
Conversion* 


Character and 
Code Conversion** 


Codettt 


Conversion* 


Code Conversion** 






Code 
(Hex) 


Char 


Code 
(Hex) 


Char 


ASCII 
Char 


Code 
(Octal) 


Code 
(Hex) 


Char 


Code 
(Hex) 


Char 


ASCII 
Char 


Code 
(Octal) 


20 


space 


00 


NUL 


space 


55 


40 


a 


60 


• 


a 


74 


21 


i 


7D 


> 


; 


66 


41 


A 


61 


a 


A 


01 


22 


ii 


02 


STX 


•■ 


64 


42 


B 


62 


b 


B 


02 


23 


# 


03 


ETX 


ft 


60 


43 


C 


63 


c 


C 


03 


24 


$ 


04 


EOT 


$ 


53 


44 


D 


64 


d 


D 


04 


25 


X 


05 


EN9 


X 


63 


45 


E 


65 


e 


E 


05 


25 


% 


05 


EN« 


space 


55 


46 


F 


66 


f 


F 


06 


26 


& 


06 


ACK 


& 


67 


47 


G 


67 


g 


6 


07 


27 


■ 


07 


BEL 


1 


70 


48 


H 


68 


h 


H 


10 


28 


( 


08 


BS 


( 


51 


49 


I 


69 


i 


I 


11 


29 


) 


09 


HT 


) 


52 


4A 


J 


6A 


J 


J 


12 


2A 


* 


0A 


LF 


* 


47 


4B 


K 


6B 


k 


K 


13 


2B 


+ 


0B 


VT 


+ 


45 


4C 


L 


6C 


I 


L 


14 


2C 


/ 


OC 


FF 


/ 


56 


4D 


N 


6D 


m 


N 


15 


2D 




0D 


CR 




46 


4E 


N 


6E 


n 


N 


16 


2E 




0E 


SO 


m 


57 


4F 





6F 








17 


2F 


/ 


OF 


SI 


1 


50 


50 


P 


70 


P 


P 


20 


30 





10 


DLE 





33 


51 


9 


71 


q 


Q 


21 


31 


1 


11 


DC1 


1 


34 


52 


R 


72 


r 


R 


22 


32 


2 


12 


DC2 


2 


35 


53 


S 


73 


s 


S 


23 


33 


3 


13 


DC3 


3 


36 


54 


T 


74 


t 


T 


24 


34 


4 


14 


DC4 


4 


37 


55 


U 


75 


u 


U 


25 


35 


5 


15 


NAK 


5 


40 


56 


V 


76 


v 


V 


26 


36 


6 


16 


SYN 


6 


41 


57 


w 


77 


w 


w 


27 


37 


7 


17 


ETB 


7 


42 


58 


X 


78 


X 


X 


30 


38 


8 


18 


CAN 


8 


43 


59 


Y 


79 


y 


Y 


31 


39 


9 


19 


EN 


9 


44 


5A 


z 


7A 


z 


Z 


32 


3A 


: 


1A 


SUB 


: 


00 


5B 


c 


1C 


FS 


C 


61 


Display code 00 is undefined at sites using the 


5C 


\ 


7C 


1 


\ 


75 


63-character set. 


5D 


r. 


01 


SOH 


3 


62 


3A 


: 


1A 


SUB 


; 


63 


5E 


<Ai 


7E 


" 


*. 


76 


3B 


# 


1B 


ESC 


/ 


77 


5F 




7F 


DEL 


_ 


65 


3C 


< 


7B 


< 


< 


72 














3D 


= 


1D 


GS 


= 


54 














3E 


> 


1E 


RS 


> 


73 














3F 


•> 


1F 


US 


7 


71 














*When these characters are copied from or to a tape, the characters 


remain the same and 


the code changes 


from/to ASCII to/from display code. 






tt These characters do not exist in display code. When the characters 


are copied from a tape, each ASCII 


character is changed to an alternate display code character. The corresponding codes are also changed. 


Example: When the system copies a lowercase a, 61-| , from tape, it 


writes an uppercase 


A, U1 8 . 


t1t A display code space always translates to an ASCII space. 







Table A-6 contains the ASCII 128-character set 
supported by the Network Access Method. A 96- 
character subset consists of the rightmost six 
columns and includes the 95-character graphic 
subset referenced previously in this appendix; the 
deletion character (DEL) is not a graphic char- 
acter. A 64-character subset consists of the 
middle four columns. Note that 6-bit display code 
equivalents exist for the characters in this 64- 
character subset only. 



Although the network supports the 128-character 
set, some terminals restrict output to a smaller 
subset. This restriction is supported by replacing 
the control characters in columns and 1 of table 
A-6 with blanks to produce the 96-character subset, 
and, additionally, replacing the characters in 
columns 6 and 7 with the corresponding characters 
from columns 4 and 5, respectively, to produce the 
64-character subset. 
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TABLE A-4. EBCDIC 9-TRACK CODED TAPE CONVERSION 



EBCDIC 



Code 
Conversion* 



Code 
(Hex) 



Char 



40 

4A 

48 

4C 

40 

4E 

4F 

50 

5A 

5B 

5C 

5D 

5E 

5F 

60 

61 

6B 

6C 

6C 

6D 

6E 

6F 

7A 

Display code 

63-character 

7A 



space 
i 

< 

( 
+ 

I 

& 
I 

$ 

* 
) 



Character and 
Code Conversion 1 * 



Code 
(Hex) 



Char 



Display 

Code m 



ASCII 
Char 



7B 
7C 
7D 
7E 
7F 
C1 
C2 
C3 
C4 
C5 



A 
B 
C 
D 
E 



00 

1C 

0E 

CO 

16 

OB 

DO 

2E 

01 

37 

25 

05 

27 

A1 

OD 

OF 

OC 

2D 

2D 

07 

1E 

1F 

3F I 
00 is undefi 
set. 

3F 
03 
79 
2F 
1D 
02 
81 
82 
83 
84 
85 



NUL 

IFS 

SO 

< 

BS 

VT 

> 

ACK 

SOH 

EOT 

LF 

HT 

ESC 

CR 
SI 
FF 
ENQ 
ENQ 
DEL 
IRS 
IUS 
SUB 
ned at 

SUB 

ETX 

\ 

BEL 

IGS 

STX 

a 

b 

c 

d 

e 



space 
C 

< 
( 
+ 
; 

S 
] 
$ 

* 
) 

l 



X 
space 

> 

t 



Code 
(Octal) 



55 
61 
57 
72 
51 
45 
66 
67 
62 
53 
47 
52 
77 
76 
46 
50 
56 
63 
55 
65 
73 
71 
00 
sites using the 



63 
60 
74 
70 
54 
64 
01 
02 
03 
04 
05 



EBCDIC 



Code 
Conversion''' 



Code 
(Hex) 



Char 



C6 


F 


C7 


G 


C8 


H 


C9 


I 


D1 


J 


D2 


K 


D3 


L 


D4 


N 


D5 


N 


D6 





D7 


P 


D8 


Q 


D9 


R 


EO 


\ 


E2 


S 


E3 


T 


E4 


U 


E5 


V 


E6 


w 


E7 


X 


E8 


Y 


E9 


Z 


FO 





F1 


1 


F2 


2 


F3 


3 


F4 


4 


F5 


5 


F6 


6 


F7 


7 


F8 


8 


F9 


9 



f AU EBCDIC codes not listed translate to display code 55g (space), 
translates to an EBCDIC space. 



Character and 
Code Conversion** 



Code 
(Hex) 



86 

87 

88 

89 

91 

92 

93 

94 

95 

96 

97 

98 

99 

6A 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

10 

11 

12 

13 

3C 

3D 

32 

26 

18 

19 



Char 



f 
g 

h 
i 

J 

k 
I 
m 
n 
o 
P 

q 

r 

I 

s 
t 
u 
v 
u 

X 

y 

z 

DLE 

DC1 

DC2 

TM 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 



Display 

Codettt 



ASCII 
Char 



F 
G 
H 
I 
J 
K 
L 

n 

N 


p 

Q 
R 
\ 
S 

T 
U 
V 

w 

X 
Y 

z 


1 

2 
3 

4 
5 
6 

7 
8 
9 



A display code space always 



Code 
(Octal) 



06 

07 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

75 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 



tt 



ttt, 



These characters do not exist in display code. When the characters are copied from a tape, each EBCDIC 
character is changed to an alternate display code character. The corresponding codes are also changed. 
Example: When the system copies a lowercase a, 81 l0 , from tape, it writes an uppercase A, 01 8 . 

When these characters are copied from or to a tape, the characters remain the same (except EBCDIC codes 
* A 16* *F16' 5Ai6, and SF^) and the code changes from/to EBCDIC to/from display code. 



Similarly, input from a device may be limited to a 
smaller subset by the device itself because the 
device cannot produce the full 128-character set. 
A character input from a device using a character 
set other than ASCII is converted to an equivalent 
ASCII character; characters without ASCII character 
equivalents are replaced by the ASCII blank char- 
acter. 



An application can also cause character replacement 
(as described previously for output) as well as 
character conversion, by requesting display-coded 
input from the network. 

The 7-bit hexadecimal code value for each character 
consists of the character's column number in the 
table, followed by its row number. For example, N 
is in row E of column 4, so its value is 4Ei£. 
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TABLE A-5. 7-TRACK CODED TAPE CONVERSIONS 



External 


ASCII 


Octal Display 


External 


ASCII 


Octal Display 


BCD 


Character 


Code 


BCD 


Character 


Code 


01 


1 


34 


40 


- 


46 


02 


2 


35 


41 


J 


12 


03 


3 


36 


42 


K 


13 


04 


4 


37 


43 


L 


14 


05 


5 


40 


44 


H 


15 


06 


6 


41 


45 


N 


16 


07 


7 


42 


46 





17 


10 


8 


43 


47 


P 


20 


11 


9 


44 


50 


Q 


21 


12* 





33 


51 


R 


22 


13 


- _ 


54 


52 


; 


66 


14 


it 


64 


53 


$ 


53 


15 


a 


74 


54 


* 


47 


16* 


X 


63 


55 


1 


70 


17 


c 


61 


56 


9 


71 


20 


space 


55 


57 


> 


73 


21 


/ 


50 


60 


+ 


45 


22 


S 


23 


61 


A 


01 


23 


T 


24 


62 


B 


02 


24 


U 


25 


63 


C 


03 


25 


V 


26 


64 


D 


04 


26 


u 


27 


65 


E 


05 


27 


X 


30 


66 


F 


06 


30 


Y 


31 


67 


G 


07 


31 


z 


32 


70 


H 


10 


32 


a 


62 


71 


I 


11 


33 
34 


( 


56 

51 


72 
73 


< 


72 
57 


35 




65 


74 


) 


52 


36 


f 


60 


75 


\ 


75 


37 


& 


67 


76 


A. 


76 






77 


/ 


77 


*As explained in the text of 


this appendix, conver: 


Hon of these codes depends on whether the tape is 


being read or written. 









Transparent Mode Transmissions 

Transparent mode is selected separately for input 
and output transmissions. During transparent mode 
input, the parity bit is stripped from each ter- 
minal transmission code (unless the N parity option 
has been selected by a Terminal Interface Program 
command), and the transmission code is placed in an 
8-bit byte without translation to 7-bit ASCII 
code. Line transmission protocol characters are 
deleted from a mode 4C terminal input stream. 



When the 8-bit bytes arrive in the host computer, a 
terminal servicing facility program such as the 
Interactive Facility can right-justify the bytes 



within a 12-bit byte. Upon transmission of 12-bit 
bytes from the host computer, the leftmost 4 bits 
(bits 11 through 8) are discarded. 

During transparent mode output, processing similar 
to that performed for input occurs. The code in 
each 8-bit byte received by the network software 
from the terminal servicing facility program is not 
translated. The parity bit appropriate for the 
terminal class being used is altered as indicated 
by the parity option in effect for the terminal. 
The codes are then output in transmission bytes 
appropriate for the codes associated with the 
terminal class being used. Line transmission 
protocol characters are inserted into a mode 4C 
terminal output stream. 
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TABLE A-6. FULL ASCII CHARACTER SET 



-128-Character Set- 



-96-Character Subset - 



-64-Character Subset- 



b7 b 










- 









1 




1 




1 
1 


1 




1 

1 


1 
1 



1 
1 
1 


6 h 

b 5 
Bits 












I 


b 3 

I 


b 2 


b 1 




N. Column 





1 


2 


3 


4 


5 


6 


7 


Row x^ ■"*■ 

















NUL 
000 


OLE 
020 


SP 
040 



060 


9 
100 


P 
120 


140 


P 
160 













1 


1 


SOH 
001 


DC1 
021 


•j 
041 


1 
061 


A 
101 


Q 
121 


a 
141 


161 










1 





2 


STX 
002 


DC2 
022 


II 

042 


2 
062 


B 
102 


R 
122 


b 
142 


r 
162 










1 


1 


3 


ETX 
003 


DC3 
023 


# 
043 


3 
063 


C 
103 


S 
123 


c 
143 


s 
163 







1 








4 


EOT 
004 


DC4 
024 


$ 

044 


4 
064 



104 


T 
124 


d 
144 


t 
164 







1 





1 


5 


ENQ 
005 


NAK 
025 


X 
045 


5 

065 


E 
105 


U 
125 


e 
145 


u 
165 







1 


1 





6 


ACK 
006 


SYN 
026 


8 
046 


6 
066 


F 

106 


V 
126 


f 
146 


V 

166 


' 





1 


1 


1 


7 


BEL 
007 


ETB 
027 


047 


7 
067 


G 
107 


W 
127 


9 
147 


u 
167 















8 


BS 
010 


CAN 
030 


( 
050 


8 
070 


H 
110 


X 
130 


h 
150 


X 

170 












1 


9 


HT 
011 


EN 
031 


) 
051 


9 

071 


I 

111 


Y 
131 


i 
151 


y 

171 









1 





A 


LF 
012 


SUB 
032 


* 
052 


072 


J 
112 


Z 
132 


j 
152 


z 
172 









1 


1 


B 


VT 
013 


ESC 
033 


+ 
053 


073 


K 
113 


Z 
133 


k 
153 


173 






1 








C 


FF 
014 


FS 
034 


054 


< 

074 


L 
114 


\ 
134 


I 
154 


I 
174 






1 





1 


D 


CR 
015 


GS 
035 


055 


075 


n 

115 


135 


m 
155 


> 
175 






1 


1 





E 


SO 
016 


RS 
036 


056 


> 

076 


N 

116 


A. 

136 


n 
156 


176 






1 


1 


1 


F 


SI 
017 


US 

037 


1 
057 


9 

077 



117 


137 




157 


DEL 

177 


LEGEND: 




























Numbers 
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the octal values 


for the 


7-bit c 


haracter 


codes u 


sed with 


in the r 
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TABLE A-7. FULL EBCDIC CHARACTER SET 



Hexa- 
decimal 
EBCDIC 
Code 


Octal 
12-Bit 
EBCDIC 
Code 


EBCDIC 
Graphic 
Character* 


EBCDIC 

Control 

Character 


Hexa- 
decimal 
EBCDIC 
Code 


Octal 
12-Bit 
EBCDIC 
Code 


EBCDIC 
Graphic 
Character* 


EBCDIC 

Control 

Character 


00 


0000 




NUL 


41 


0101 




undefined 


01 


0001 




SOH 


thru 


thru 






02 


0002 




STX 


49 


0111 






03 


0003 




ETX 


4A 


0112 


6 




04 


0004 




PF 


4B 


0113 


. 




05 


0005 




HT 


4C 


0114 


< 




06 


0006 




LC 


4D 


0115 


( 




07 


0007 




DEL 


4E 


0116 


+ 




08 


0010 




undefined 


4F 


0117 


I 




09 


0011 




undefined 


50 


0120 


8 




0A 


0012 




SMM 


51 


0121 




undefined 


OB 


0013 




VT 


thru 


thru 






OC 


0014 




FF 


59 


0131 






OD 


0015 




CR 


5A 


0132 


i 




OE 


0016 




SO 


5B 


0133 


$ 




OF 


0017 




SI 


5C 


0134 


* 




10 


0020 




DLE 


5D 


0135 


) 




11 


0021 




DC1 


5E 


0136 


7 




12 


0022 




DC2 


5F 


0137 


—\ 




13 


0023 




TH 


60 


0140 


- 




14 


0024 




RES 


61 


0141 


/ 




15 


0025 




NI- 


62 


0142 




undefined 


16 


0026 




BS 


thru 


thru 






17 


0027 




IL 


69 


0151 






18 


0030 




CAN 


6A 


0152 


i 
i 




19 


0031 




EM 


6B 


0153 


9 




1A 


0032 




CC 


6C 


0154 


% 




1B 


0033 




CU1 


6D 


0155 






1C 


0034 




IFS 


6E 


0156 


> 




1D 


0035 




IGS 


6F 


0157 


? 




1E 


0036 




IRS 


70 


0160 




undef i ned 


1F 


0037 




IUS 


thru 


thru 






20 


0040 




DS 


78 


0170 






21 


0041 




SOS 


79 


0171 


* 




22 


0042 




FS 


7A 


0172 


: 




23 


0043 




undefined 


7B 


0173 


H 




24 


0044 




BYP 


7C 


0174 


a 




25 


0045 




LF 


7D 


0175 


i 




26 


0046 




ETB or EOB 


7E 


0176 


» 




27 


0047 




ESC or PRE 


7F 


0177 


!• 




28 


0050 




undefined 


80 


0200 




undefined 


29 


0051 




undefined 


81 


0201 


a 




2A 


0052 




SN 


82 


0202 


b 




2B 


0053 




CU2 


83 


0203 


c 




2C 


0054 




undefined 


84 


0204 


d 




2D 


0055 




ENCt 


85 


0205 


e 




2E 


0056 




ACK 


86 


0206 


f 




2F 


0057 




BEL 


87 


0207 


g 




30 


0060 




undefined 


88 


0210 


h 




31 


0061 




undefined 


89 


0211 


i 




32 


0062 




SYN 


8A 


0212 




undefined 


33 


0063 




undefined 


thru 


thru 






34 


0064 




PN 


90 


0220 






35 


0065 




RS 


91 


0221 


J 




36 


0066 




UC 


92 


0222 


k 




37 


0067 




EOT 


93 


0223 


I 




38 


0070 




undefined 


94 


0224 


IB 




39 


0071 




undefined 


95 


0225 


n 




3A 


0072 




undefined 


96 


0226 


o 




3B 


0073 




CU3 


97 


0227 


P 




3C 


0074 




DC4 


98 


0230 


q 




3D 


0075 




NAK 


99 


0231 


r 




3E 


0076 




undefined 


9A 


0232 




undefined 


3F 


0077 




SUB 


thru 


thru 






40 


0100 


space 




AO 


0240 
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TABLE A-7. FULL EBCDIC CHARACTER SET (Contd) 



Hexa- 


Octal 






Hexa- 


Octal 






decimal 


12-Bit 


EBCDIC 


EBCDIC 


decimal 


12-Bit 


EBCDIC 


EBCDIC 


EBCDIC 
Code 


EBCDIC 
Code 


Graphic 
Character* 


Control 
Character 


EBCDIC 
Code 


EBCDIC 
Code 


Graphic 
Character''' 


Control 
Character 


A1 


0241 


- 




D7 


0327 


P 




A2 


0242 


s 




D8 


0330 


a 




A3 


0243 


t 




D9 


0331 


R 




A4 


0244 


u 




DA 


0332 




undefined 


A5 


0245 


V 




thru 


thru 






A6 


0246 


w 




DF 


0337 






A7 


0247 


X 




EO 


0340 


\ 




A8 


0250 


y 




E1 


0341 




undefined 


A9 


0251 


z 




E2 


0342 


S 




AA 


0252 




undefined 


E3 


0343 


T 




thru 


thru 






E4 


0344 


U 




BF 


0277 






E5 


0345 


V 




CO 


0300 


< 




E6 


0346 


u 




C1 


0301 


A 




E7 


0347 


X 




C2 


0302 


B 




E8 


0350 


Y 




C3 


0303 


C 




E9 


0351 


z 




C4 


0304 


D 




EA 


0352 




undefined 


C5 


0305 


E 




EB 


0353 




undefined 


C6 


0306 


F 




EC 


0354 


rl 




C7 


0307 


G 




ED 


0355 




undefined 


C8 


0310 


H 




thru 


thru 






C9 


0311 


I 




EF 


0357 






CA 


0312 




undefined 


FO 


0360 







CB 


0313 




undefined 


F1 


0361 


1 




CC 


0314 


f 




F2 


0362 


2 




CD 


0315 


V 


undefined 


F3 


0363 


3 




CE 


0316 






F4 


0364 


4 




CF 


0317 




undefined 


F5 


0365 


5 




DO 


0320 


> 




F6 


0366 


6 




D1 


0321 


J 




F7 


0367 


7 




D2 


0322 


K 




F8 


0370 


8 




D3 


0323 


L 




F9 


0371 


9 




D4 


0324 


M 




FA 


0372 


I 




D5 


0325 


N 




FB 


0373 




undefined 


D6 


0326 







thru 


thru 














FF 


0377 






'Graphic 


characters s 


houn are those i 


jsed on the IBH System/370 standard <PN) print train. Other devices 


support 


subsets or v 


ariations of th 


s character graphic set. 
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DIAGNOSTICS 



B 



Diagnostic messages that can be issued by Sort/ 
Merge are listed in table B-l. If an error occurs, 
the error level and the error number are written on 
the error file or the listing file. The diagnostic 
message is written on the next line. For errors 
numbered 1 through 40, the parameter statement that 
is in error is written on another line, and a 
pointer indicates the position of the error in the 
parameter statement. 

An error can be one of the following levels: 

T Trivial; a trivial diagnostic results from 
a usage that is syntactically correct but 
questionable. 

W Warning; a warning diagnostic results from 
a usage that is syntactically incorrect, 



but from which Sort/Merge has been able to 
recover by making an assumption about what 
was intended. 

F Fatal; a fatal diagnostic results when 
Sort/Merge cannot resolve a syntactic or 
semantic error. The remaining parameter 
statements are read, but no Sort/Merge 
processing occurs. 

C Catastrophic; a catastrophic error causes 
immediate Sort/Merge termination. 



Specifying the STATUS parameter or calling the 
SM5ST procedure prevents job step termination after I 
any data records are input; the status variable I 
indicates the highest level of error that occurred. 



TABLE B-l. SORT/MERGE DIAGNOSTICS 



Error 

Number 



Error 
Level 



Message 



A SPACE OR , EXPECTED 



CHARACTERS USED OUTSIDE 
A STRING OR NAME MUST 
BE A LETTER DIGIT ) = 
( ' , OR SPACE 



A VALUE SHOULD FOLLOW 
THIS KEYWORD 



UNDEFINED COLLATING 
SEQUENCE 



CHARACTER AFTER KEYWORD 
MUST BE SPACE OR = 



INVALID KEYWORD 
DETECTED 

UNLESS IN A STRING, = 
SHOULD FOLLOW ONLY A 
KEYWORD 



DUPLICATE COLLATING 
SEQUENCE NAME FOUND. 



Significance 



A space or a comma must sep- 
arate parameters in a control 
statement or directive file. A 
space or a comma must also sep- 
arate values in a set of values 
specified for a parameter. 

Unless in a literal string or 
in the name of a user-supplied 
entity, only alphabetic and 
numeric characters and the 
special characters ) = ( ' , 
and space are valid in a con- 
trol statement or directive 
file. 

At least one value must be 
specified following a 
parameter keyword. 

The name of a key type in a KEY 
parameter is not a predefined 
collating sequence or a se- 
quence you have defined with 
SEQx parameters. 

A parameter keyword must be 
separated from its value by an 
= or space. 

The indicated keyword is not a 
valid procedure call keyword. 

Unless an = is in a literal 
string, •= is only valid immedi- 
ately following a parameter 
keyword. 

Collating sequence names must 
be unique. 



Action 



Insert a space or a comma 
between each parameter and 
between values specified 
for a parameter. 



Replace invalid characters 
with valid characters. 



Insert a value following 
the parameter keyword. 



Change the name of the key 
type to one of the prede- 
fined collating sequences 
or a sequence you have 
defined. 

Insert an = after the 
parameter keyword. 



Determine valid procedure 
call keywords. 



Replace the invalid 
a valid character. 



with 



Eliminate the duplicate 
name. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 



Error 
Level 



10 



11 



13 



14 



15 



17 



19 



20 



21 



22 



Message 



( ) MUST ENCLOSE A 
VALUE 



CHARACTER AFTER = MUST 
BE LETTER, DIGIT ( $ ' 
OR SPACE 



THIS VALUE SHOULD BE> A 
STRING (DELIMITED WITH 
"ST 

THIS COMMA SHOULD BE 
FOLLOWED BY A LETTER, 
DIGIT, SPACE , OR ( 



THIS CHARACTER MUST BE 
A LETTER, DIGIT ( ' 
OR , 



TOO MANY PARAMETER 
POSITIONS HAVE BEEN 
SPECIFIED 



CHARACTER AFTER ) MUST 
BE SPACE ) OR , 



CHARACTER AFTER ( MUST 
BE A LETTER, DIGIT $ ' 
( OR SPACE 



THE HIGH AND LOW VALUES 
OF THIS RANGE MUST BE 
AN INTEGER, Rl, R2, R3, 
RIG, EF OR EFG 



THE HIGH AND LOW VALUES 
OF THIS RANGE MUST BE A 

STRING 



CHARACTER FOLLOWING AN 
INTEGER MUST BE ) . . , 
SPACE OR LETTER 



POSITIONAL VALUES ARE 
NOT ALLOWED IN A VALUE- 
SET 



Significance 



Parentheses in a control state- 
ment or directive file must 
enclose a parameter value. 

Only an alphabetic or numeric 
character or one of the special 
characters ( $ ' or space can 
follow an = . 

The indicated value must be a 
literal string enclosed in 
apostrophes'* 

The indicated comma must be 
followed by an alphabetic or 
numeric character or one of the 
special characters , ( or 
space. 

The indicated character must be 
an alphabetic or numeric char- 
acter or one of the special 
characters ( ' or , . 

When specifying parameters by 
position rather than by key- 
word, a maximum of 31 positions 
is allowed; you have probably 
included too many commas . 

A right parenthesis can only be 
followed by another right 
parenthesis, a comma, or a 
space. 

A left parenthesis can only be 
followed by an alphabetic or 
numeric character, another left 
parenthesis, a $ ' or space. 

If a range of values is speci- 
fied for the KEY, SUM, or ENR 
parameter, the high and low 
values of the range must be 
integers or the CCL variables 
Rl, R2, R3, RIG, EF, or EFG. 

If the SEQS parameter specifies 
a range of values, the high and 
low values of the range must be 
literal strings enclosed in 
apostrophes . 

Only a ) .. (indicating a 
range of values), a comma, a 
space, or a letter can follow 
an integer. 

In a KEY or SUM parameter 
value-set, key or sum field 
characteristics must be speci- 
fied in the order shown in the 
parameter formats; values 
cannot be omitted and replaced 
by commas. 



Action 



Place a parameter value 
between the parentheses. 



Replace the character fol- 
lowing the = with a valid 
character. 



Enclose the indicated value 
in apostrophes. 



Replace the character fol- 
lowing the indicated comma 
with a valid character. 



Replace the indicated char- 
acter with a valid 
character. 



Check your control state- 
ment for excess commas. 



Replace the invalid char- 
acter after the right 
parenthesis with a valid 
character. 

Replace the invalid char- 
acter after the left 
parenthesis with a valid 
character. 

Replace the invalid range 
value with an integer, Rl , 
R2, R3, RIG, EF, or EFG. 



Replace the invalid range 
with a literal string 
enclosed in apostrophes. 



Replace the invalid char- 
acter following the integer 
with a valid character. 



In a KEY parameter, specify 
field position, length and 
type if you specify order; 
specify field position and 
length if you specify type. 
In a SUM parameter, specify 
field position, length and 
type if you specify repeti- 
tions . 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 

Number 


Error 
Level 


Message 


Significance 


Action 


23 


W 


A PERIOD CANNOT BE USED 


A period is not a valid sepa- 


Replace the invalid period 






IN A PARAMETER-LIST 


rator in a parameter list. 


with a valid separator; 
refer to the parameter 
syntax to determine valid 
separators . 


24 


F 


A RANGE IS ONLY ALLOWED 


A range of values can be speci- 


Replace the invalid range 






AS A VALUE FOR ENR, KEY 


fied only for the ENR, KEY, or 


with a single value. 






OR SUM PARAMETERS 


SUM parameters; single values 
must be specified for other 
parameters. 




25 


F 


UNLESS $CHAR(N) IS 


More than two parentheses can 


Delete the extra 






USED, ONLY ONE SET OF 


appear together only when 


parentheses. 






NESTED PARENTHESES IS 


$CHAR(n) is used in a SEQS 








ALLOWED 


parameter to specify steps in a 
collating sequence. 




26 


W 


UNLESS WITHIN A STRING, 


A set of values specified for a 


Correct the syntax for the 






NEITHER . NOR = IS 


parameter can contain a period 


indicated values. 






ALLOWED WITHIN A VALUE 


or an = only in a literal 








SET 


string. 




27 


F 


THIS VALUE SHOULD BE A 


The indicated value must be the 


Use a file or procedure 






FILE OR PROC NAME 


name of a file or procedure. 


name for the indicated 
value. 


29 


F 


PARENTHESES MUST BE 


If a right or left parenthesis 


Insert the missing 






MATCHED IN THE 


appears in a parameter list, it 


parenthesis. 






PARAMETER-LIST 


must be matched in the list by 
its opposite. 




30 


F 


TOO FEW SETS GIVEN FOR 


The indicated keyword must have 


Insert the values that must 






THE KEYWORD ENDED HERE 


a specific set of values speci- 
fied for it; a value or values 
are missing . 


be specified for the 
indicated keyword. 


31 


F 


TOO MANY VALUE-SETS 


The indicated keyword must have 


Determine the values that 






GIVEN FOR THIS KEYWORD- 


a specific set of values 


can be specified for the 






VALUE-LIST 


specified for it; too many 
values have been specified. 


indicated keyword. 


32 


F 


THIS VALUE SHOULD BE AN 


The indicated value must be an 


Replace the invalid value 






INTEGER 


integer. 


with an integer value. 


33 


F 


TOO MANY VALUES 


Too many values have been 


Determine the values that 






SPECIFIED IN THIS 


specified for the indicated set 


can be specified in the 






VALUE -SET 


of values in a list of 
parameter values. 


indicated set of values. 


34 


F 


TOO FEW VALUES 


Too few values have been speci- 


Determine the values that 






SPECIFIED IN THIS 


fied for the indicated set of 


can be specified in the 






VALUE-SET 


values in a list of parameter 
values . 


indicated set of values. 


35 


F 


ONLY A , ) ..OR SPACE 


Parameter values must be 


Replace the invalid 






CAN FOLLOW A PARAMETER 


followed by a , ) . . or space. 


character following the 






VALUE 




parameter value with a 
valid character. 


37 


F 


THIS PARAMETER VALUE 


The indicated parameter value 


Replace the indicated 






MUST BE A SET OR A 


cannot be a single value; the 


parameter value with a 






RANGE 


value must be a set of values 
or a range of values. 


valid set or range of 
values. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 





Error 
Number 


Error 
Level 


Message 


Significance 


Action 




50 


W 


DIALOG PARAMETER CAN 


The DIALOG parameter cannot be 


Specify the DIALOG parame- 








ONLY BE SPECIFIED IN A 


in a directive file. 


ter in a control statement. 








CONTROL STATEMENT 








51 


F 


ONLY 3 VALUES CAN BE 


Values in a KEY or SUM parame- 


Correct the KEY or SUM 








GIVEN IN KEY/ SUM VALUE- 


ter value-set are separated by 


parameter so that no more 








SET IF F. .L FORMAT IS 


commas or spaces. If you use 


than three values are 








USED 


the first.. last form to specify 
key or sum field position and 
length, a maximum of two other 


specified. 








- -- --- - 


values (separated by commas or 
spaces) is allowed. 


- - - ----- 


1 


52 


F 


FILE, PROC, AND COL-SEQ 


A letter (A-Z) must be the 


Begin each file name, pro- 








NAMES MUST BEGIN WITH A 


first character in a file name, 


cedure name, and collating 








LETTER 


procedure name, or the name of 
a collating sequence you have 
defined. 


sequence name with a 
letter. 




53 


F 


VALUES ALLOWED FOR THE 


Valid values for the FASTIO 


Specify a valid value for 








FASTIO PARAMETER ARE 


parameter are YES or NO, which 


the FASTIO parameter. 








YES AND NO 


can be specified as Y or N. 






54 


W 


MORE THAN 100 INPUT 


No more than 100 files can be 


The files in excess of 100 








FILES GIVEN, ONLY THE 


sorted in any one job step; 


can be sorted in a separate 








FIRST 100 SORTED 


files specified in excess of 
100 are ignored. 


job step. 




56 


F 


IF THE FIRST VALUE OF A 


Single characters cannot follow 


Correct the SEQS parameter 








SEQS IS A RANGE THEN 


a range of characters in a SEQS 


so that it consists of 








ALL OTHER VALUES OF 


parameter. 


ranges of characters with 








THAT SEQS MUST BE 




the same number of charac- 








RANGES OF THE SAME 




ters in each range. 








LENGTH 








57 


F 


WHEN LOW.. HIGH IS USED 


If a range of characters is 


Correct the SEQS parameter 








AS A VALUE FOR SEQS LOW 


used in a SEQS parameter, the 


so that the first character 








MUST BE LESS THAN HIGH 


first character in the range 
must be of less value than the 

last . 


in the range is less than 
the last. 




58 


F 


ONLY SINGLE CHARACTER 
STRINGS OR $CHAR CAN BE 
USED AS VALUES FOR SEQS 


Each character specified in a 
SEQS parameter must be enclosed 
in apostrophes and separated 
from other characters by . . or 
a comma; characters cannot be 
grouped together. $CHAR(n) 
must specify a single charac- 
ter. 


Correct the SEQS parameter. 




59 


F 


FOR $CHAR(N), N MUST BE 


If $CHAR(n) is used in a SEQS 


Specify n as a positive 








A POSITIVE DECIMAL 


parameter to specify a value 


decimal integer. 








INTEGER 


step consisting of one charac- 
ter, n must be a positive deci- 
mal integer that corresponds to 
the number of the intended 
character in your character 




1 








set . 




61 


F 


FILE NAMES MUST NOT 


A file name can be no longer 


Change the name of the file 








EXCEED 7 CHARACTERS IN 


than 7 characters. 


to a name that is 7 charac- 








LENGTH 




ters or fewer in length. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 



Error 
Level 



Message 



Significance 



Action 



62 



63 



64 



65 



67 



68 



69 



70 



71 



72 



73 



74 



75 



THE MAXIMUM LENGTH OF A 
LINE IS 240 CHARACTERS 



VALUES ALLOWED FOR THE 
DIALOG PARAMETER ARE 
YES AND NO 

A SPACE OR , MUST 
FOLLOW THE SORT OR 
MERGE VERBS IN DIR. 
FILE 



A PERIOD MUST FOLLOW 
S0RT5 OR MERGE 



DIRECTIVE FILE NAMES 
MUST BE UNIQUE 



LINES CONTINUING THE 
SORT5 OR MERGE 
PARAMETER-LIST MUST 
BEGIN WITH A PERIOD 

FILE NAMES CAN CONTAIN 
ONLY LETTERS AND DIGITS 

LENGTH MUST BE 
SPECIFIED IF TYPE IS 
SPECIFIED 



KEY LENGTH FOR KEYTYPE 
REAL MUST BE 10 



ONLY THE VALUES A OR D 
ARE ALLOWED AS VALUES 
FOR KEY ORDER 



UNEQUAL FL FOR INPUT 
AND OUTPUT FILES WITH 
RT=F OR RT=Z 



VALUES ALLOWED FOR THE 
EL PARAMETER ARE T, W, 
F OR C 

VALUES ALLOWED FOR THE 
LO PARAMETER ARE OFF, S 
AND A 



The S0RT5 or MERGE control 
statement and its associated 
parameter list can be no longer 
than 240 characters (periods 
used as continuation indicators 
are not counted) . 

Valid values for the DIALOG 
parameter are YES or NO, which 
can be specified as Y or N. 

In a directive file, any state- 
ment that begins with SORT or 
with MERGE must have a space or 
a comma immediately following 
SORT or MERGE. 

In a control statement , the 
word SORT5 or the word MERGE 
must be immediately followed by 
a period. 

A directive file cannot have 
the same name as any other 
directive file used in the sort 
or merge. 

Any line of a S0RT5 or a MERGE 
control statement that is con- 
tinued beyond the first line 
must begin with one period. 

A file name cannot contain any 
special characters. 

If the key type is other than 
the default ASCII6, or if 
ASCII6 is explicitly specified, 
key length cannot be omitted. 

Keys declared to be of type 
REAL must occupy a full compu- 
ter word and must be specified 
as 10 bytes in length. 

Sort order can be specified as 
ascending with A or as descend- 
ing with D. 



If you specify different fixed 
length for input and output 
files, Sort/Merge compresses or 
expands records to fit into the 
fixed length. 

The only values that can be 
specified for the EL parameter 
are T, W, F, or C. 

The only values that can be 
specified for the LO parameter 
are OFF, S, or A. 



Parameters can be placed in 
a directive file so that 
the control statement is 
240 characters or less. 



Specify a valid value for 
the DIALOG parameter. 



Insert a space or a comma 
immediately following SORT 
or MERGE in your directive 
file. 



Insert a period immediately 
following the word SORT5 or 
the word MERGE. 



Give all directive files 
different names. 



Begin each continuation 
line with one period. 



Omit special characters 
from the file name. 

Specify key length. 



Specify length of REAL key 
as 10. 



Specify either A or D for 
sort order; or omit speci- 
fication of sort order and 
ascending is assumed. 

For the most efficient pro- 
cessing, specify the same 
FL for input and output 
files. 



Specify T, W, F, or C as 
the value of the EL 
parameter. 

Specify OFF, S, or A as the 
value of the LO parameter. 
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Error 

Number 



76 



77 



78 



79 



80 



Error 
Level 



82 



83 



84 



85 



86 



Message 



VALUES ALLOWED AS 
EXPRESSIONS ARE 
INTEGER, Rl, R2, R3, 
RIG, EF OR EFG 

$NULL SHOULD NOT BE 
USED AS A VALUE WITHIN 
A SET OF VALUES 



VALUES ALLOWED FOR THE 
ST PARAMETER ARE Rl, 
R2, R3, RIG, EF OR EFG 



VALUES ALLOWED FOR THE 
RETAIN PARAMETER ARE 
YES AND NO 



OWNMRL AND OWNFL SHOULD 
NOT BOTH BE SPECIFIED 
FOR THE SAME SORT 



SUM AND KEY FIELDS MAY 
NOT OVERLAP 



LINES IN A DIRECTIVE 
FILE MUST BE HO LONGER 
THAN 100 CHARACTERS IN 
LENGTH 



REPETITION VALUE OF A 
SUM FIELD MUST BE AN 
INTEGER 

VALUES ALLOWED FOR OWNT 
PARAMETER ARE OLD AND 
NEW 

IN A KEY/SUM VALUE-SET 
USING FIRST.. LAST, 
LAST IS LESS THAN FIRST 



Significance 



NUMERIC KEY TYPES ARE 
THE ONLY TYPES VALID 
FOR SUM FIELDS 



The only values that can be 
specified as expressions are 
integers or the CCL variables 
Rl, R2, R3, RIG, EF, or EFG. 

$NULL is a reserved file name 
signifying a null file; it must 
not be specified in a list of 
multiple files. $NULL can be 
specified as a single value for 
a parameter ,_ 

The only values that can be 
specified for the STATUS param- 
eter are the CCL variables Rl, 
R2, R3, RIG, EF, or EFG. 

The only values that can be 
specified for the RETAIN param- 
eter are YES or NO, which can 
be abbreviated as Y or N. 

In a sort with owncode rou- 
tines , record length must be 
specified with either the 
OWNMRL parameter or the OWNFL 
parameter. 



The same characters in a record 
cannot be included in a sum 
field and a key field. 



A directive file statement, 
beginning with SORT or MERGE, 
can be 240 characters in 
length, but each liue in the 
statement must contain no more 
than 100 characters. 

In a SUM parameter, the number 
of fields to be summed must be 
expressed as an integer value . 

The only values that can be 
specified for the OWNT param- 
eter are OLD or NEW. 

In a KEY or SUM parameter, if 
field length and position are 
specified as the first and last 
bytes or bits of the field then 
the first byte or bit must be 
less than the last byte or bit 
(the leftmost byte or bit in a 
record is counted as number 1). 

In a SUM parameter, sum field 
type must be the name of a num- 
eric data format except REAL; 
type cannot be a collating 
sequence . 



Action 



Specify a valid expression. 



Delete SNULL from the list 
of files, or specify $NULL 
as the single parameter 
value. 



Specify a valid value for 
the STATUS parameter. 



Specify a valid value for 
the RETAIN parameter. 



Specify record length with 
the OWNFL parameter for F 
or Z type records; specify 
record length with the 
OWNMRL parameter for all 
other record types. 

Correct SUM parameter and/ 
or KEY parameter so that 
the same characters are not 
included in both field 
descriptions. 

Use continuation lines in 
your directive file so that 
each line contains no more 
than 100 characters. 



Specify number of fields to 
be summed as an integer. 



Specify OLD or NEW as the 
value for the OWNT param- 
eter. 

Correct the KEY or SUM 
parameter. 



Correct the SUM parameter. 
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Error 
Number 


Error 
Level 


Message 


Significance 


Action 


87 


C 


LINES OF A DIR FILE 


In a directive file, each line 


Correct the directive file; 






MUST BEGIN WITH SORT OR 


must begin with the word SORT 


determine the proper format 






MERGE VERB, OR BE A 


or MERGE or, if the line is a 


for directive files. 






CONTINUATION 


continuation line, with a char- 
acter of your parameter list or 
one or more spaces. 




88 


F 


BYTE/BIT POSITION OR 


In a SUM or KEY parameter, 


Correct the SUM or KEY 






LENGTH OF A SUM/KEY 


field length and position must 


parameter. (Make sure two 






FIELD MUST BE AN 


be specified as integers, 


sets of parentheses enclose 






INTEGER 


counting the leftmost byte or 
bit in a record as number 1. 


the value- set.) 


89 


F 


SEQN VALUE MUST NOT BE 


When you are defining your own 


Give your collating 






ONE OF THE PREDEFINED 


collating sequence with SEQx 


sequence a unique name that 






KEY-TYPES 


parameters, the name of your 
collating sequence cannot be 
the same as the name of one of 
the predefined collating 
sequences. 


is not the same as one of 
the predefined collating 
sequences. 


90 


F 


SEQR AND SEQA MAY BE 


When you are defining your own 


Specify SEQR and SEQA only 






SPECIFIED ONLY ONCE FOR 


collating sequence with SEQx 


once. 






EACH COLLATING SEQUENCE 


parameters, SEQR and SEQA must 
not be specified more than 
once. 




91 


F 


SEQN MUST BE SPECIFIED 


When you are defining your own 


Specify SEQN before you 






BEFORE ANY OTHER SEQ 


collating sequence with SEQx 


specify any other SEQx 






PARAMETER CAN BE GIVEN 


parameters, the SEQN parameter 
naming your collating sequence 
must be the first SEQx 
parameter . 


parameter. 


92 


F 


VALUES ALLOWED FOR SEQR 


The only values that can be 


Specify a valid value for 






AND SEQA PARAMETERS ARE 


specified for the SEQR and SEQA 


the SEQR and SEQA param- 






YES AND NO 


parameters are YES or NO, which 
can be abbreviated as Y or N. 


eters. 


93 


F 


SEQN SHOULD NOT BE 


When you are defining your own 


Correct the order of the 






GIVEN WITHOUT GIVING 


collating sequence with SEQx 


SEQx parameters. 






SEQS OR SEQR BEFORE THE 


parameters, you must specify 








NEXT SEQN 


the characters in your col- 
lating sequence with SEQS and 
SEQR parameters before naming 
another collating sequence. 




94 


F 


VALUES ALLOWED FOR SEQS 


When you are defining your own 


Correct the SEQS param- 






PARAMETER ARE STRINGS 


collating sequence with SEQx 


eters. 






AND $CHAR(N) 


parameters, the only valid 
values for SEQS parameters are 
characters enclosed in apostro- 
phes or $CHAR(n) where n is the 
number of the character in your 
character set. 




95 


F 


TWO RANGES OF 


When you are defining your own 


Correct the SEQS parameter 






CHARACTERS USED IN THE 


collating sequence with SEQx 


so that it specifies ranges 






SAME SEQS MUST BE THE 


parameters, the ranges in any 


that are all the same 






SAME LENGTH 


one SEQS parameter must all be 
the same length. 


length. 
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Error 
Number 



Error 

Level 



96 



97 



98 



99 



100 



101 



102 



103 



104 



107 



108 



110 



111 



Message 



VALUE GIVEN IN THE 
$CHAR FUNCTION MUST BE 
AN INTEGER 



CHARACTERS GIVEN IN A 
SINGLE COLLATING 
SEQUENCE MUST APPEAR 
ONLY ONCE 



COL-SEQUENCE NAMES 
LONGER THAN 10 
CHARACTERS ARE 
TRUNCATED 



NUMBER OF KEY AND /OR 
SUM CHARACTERS MUST BE 
LESS THAN 256 

SIGNED NUMERIC CHARAC- 
TER FIELD IS TOO SHORT 



NO PARAMETER CAN BE 
SPECIFIED MORE THAN 
ONCE ON ONE LINE 

DUPLICATE PARAMETER 
SPECIFIED 

EITHER AN INPUT FILE, 
OWN1 OR OWN2 MUST BE 
GIVEN 

EITHER AN OUTPUT FILE, 
OWN3 OR 0WN4 MUST BE 
GIVEN 

INCORRECT PARAMETER 

VALUE 



TOO FEW/MANY PARAMETERS 



CALL OUT OF SEQUENCE 



INVALID NAME GIVEN FOR 
SM5SEQN 



Significance 



When you are defining your own 
collating sequence with SEQx 
parameters and are using 
$CHAR(n) to specify the charac- 
ters in the sequence, n must be 
a decimal integer corresponding 
to the number of the intended 
character in your character set. 

When you are defining your own 
collating sequence with SEQx 
parameters , a character cannot 
appear more than once in all 
the SEQS parameters. 

You can specify a collating 
sequence name of up to 31 char- 
acters in length, but only the 
first 10 characters are sig- 
nificant. 

A record cannot contain more 
than 255 characters that are 
defined as key or sum fields. 

A key field defined by a KEY 
parameter or SM5KEY call as 
one of the signed numeric data 
formats is not long enough to 
contain the data. 

Parameters that can be specified 
more than once must be on separ- 
ate lines. 

Some parameters can only be 
specified once. 

No sort input file given. 



No sort output file given. 



A value specified as a proce- 
dure call parameter is not a 
valid value. 

Either too few or too many 
parameters have been specified 
in a procedure call. 

A call to a Sort/Merge FORTRAN 
procedure is not in the proper 

order . 

The name of a user-defined col- 
lating sequence specified with 
the SM5SEQN call must begin 
with a letter and consist of 
letters, digits, and the 
special characters 1 it @ _. 



Action 



Specify a of SCHAR(n) as a 
decimal integer. 



Specify each character only 
once in a collating 
sequence. 



None . 



Specify the total number 
of key and sum characters 
together as 255 or less. 

Redefine the key field as 
long enough to contain all 
the numeric characters and 
the sign . 



Inspect parameters and 
correct error(s). 



Inspect parameters and 
correct error(s). 

Specify a sort input file , 
or 0WN1 or 0WN2. 



Specify a sort output file, 
or OWN1 or 0WN2. 



Check values that can be 
specified for the procedure 
call parameter. 

Determine parameters that 
can be specified in the 
procedure call. 

Determine procedure call 
order. 



Correct the name specified 

with the SM5SEQN call; 

enclose the name in apos- 
trophes. 
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Error 

Number 



Error 
Level 



Message 



Significance 



Action 



112 



113 



114 



115 



116 



117 



118 



119 



120 



121 



122 



151 



ONLY SINGLE CHARACTER 
LITERALS CAN BE USED AS 
PARAMETERS OF SM5SEQS 



RECORD LENGTH IS 
GREATER THAN MAXIMUM 
RL - 5000 



SUM FIELDS MAY NOT 
EVALUATE TO MORE THAN 
60 BITS 



RETAIN AND SUMMING MAY 
NOT BE SPECIFIED AT THE 
SAME TIME 

MRL/FL IS NOT LARGE 
ENOUGH TO ACCOMMODATE 
THE SPECIFIED KEYS 



FASTIO PARAMETER 
DISABLED FOR FILES 
ON MASS STORAGE 



NOT 



FASTIO PARAMETER WAS 
SPECIFIED BUT COULD NOT 
BE PROCESSED 



FOR KEY AND SUM FIELDS, 
THE BEGINNING POSITION 
AND THE LENGTH MUST BE 
NON-ZERO. 

SUMMING OVERFLOW 
OCCURRED - SEE DAYFILE 
FOR DETAILS. 

UNABLE TO LOAD USER 
OWNCODE - SORT DID 
NOT COMPLETE. 

OWNCODE WAS SPECIFIED 
BUT NO OWNF FILE WAS 
GIVEN. 

NOT SORT, MERGE OR 
OUTPUT; 'SORT' ASSUMED 



Each character in a user- 
defined collating sequence 
specified as parameters of 
the SM5SEQS procedure must be 
specified separately, enclosed 
in apostrophes, and separated 
from other characters by 
commas . 

Record length is set by the full 
length (FL) or maximum record 
length (MRL) file information 
table (FIT). Also, the OWNFL 
and OWNMRL parameters or SM50FL 
and SM50MRL procedures specify 
the length of a record. 5000 
is the maximum record length 
supported; records that exceed 
5000 characters may generate 
subsequent errors that may 
abort the sort. 

Summing is handled with integer 
arithmetic. Integer and binary 
sum fields can be no more than 
60 bits long. 

You cannot specify both the 
RETAIN and the SUM parameter in 
the same sort or merge. 

The record size (MRL or FL) is 
not large enough to accommodate 
the specified keys. 

The FASTIO parameter cannot 
process tapes. 



FASTIO files must have the 
same record type and length, 
and must reside on mass 
storage. 

The beginning position and 
length of key and sum fields 
must be non— zero. 



Sum fields in the output file 
have invalid data. 



A fatal loader error occurred. 



OWNF parameter was omitted. 



In the SMFILE call, file dis- 
position must be indicated as 
SORT, MERGE, or OUTPUT. 



Specify each character in 
your collating sequence as 
a separate literal enclosed 
in apostrophes. 



If subsequent errors abort 
the sort, reduce the 
number of characters per 
record to 5000 or less. 



Correct the specification 
of the sum field. 



Remove the RETAIN or SUM 
parameter. 



Change your key or file 
description. 



None necessary. 



Recheck file 
specifications. 



Correct the key /sum 
specification. 



Check data and summing 
specifications. 



Check your owncode files. 



Specify the OWNF parameter. 



None, or change SMFILE 
call to indicate MERGE or 
OUTPUT. 
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Error 
Number 


Error 
Level 


Message 


Significance 


Action 


152 


C 


RETURNED FROM CWNCODE 
WITHOUT CALLING SMRTN 


Control has returned to Sort/ 
Merge from an owncode routine 
without using a call to SMRTN; 
processing terminates. 


Determine the proper method 
of calling SMRTN. 


153 


C 


TOO MANY ERRORS FOUND. 
PROCESSING TERMINATED. 


The maximum number of errors 
for one call to Sort/Merge have 
occurred; processing terminates. 


Correct errors and resubmit 
job. 


154 


F 


SMRTN CALL ILLEGAL WITH 
. SM5 ^PROCEDURES - RUN _ 
ABORTED. 


The Sort/Merge 4 compatible 
routine SMRTN has been called 
by a set of owncode procedures 
using SM5xxx calls. 


Change SMRTN to RETURN or 
the equivalent. 


155 


C 


RETURN CODE MUST BE IN 
RANGE 0-3 


The return code from all own- 
code routines must be 0, 1, 2, 
or 3. 


Change the value of the 
return code. 


156 


W 


AN INPUT RECORD WAS 
READ WHICH WAS TOO 
SHORT TO HOLD THE 
KEY/ SUM FIELDS 
SPECIFIED FOR THIS 
SORT/MERGE. 


The order of the records is 
undefined if the key fields 
are not within the record. 


Change your key 
description 


157 


C 


NEITHER SORT NOR MERGE 
HAS BEEN SPECIFIED 


You have omitted a call to 
SM5SORT or SM5MERGE. 


Call SM5SORT or 
SM5MERGE before any 
other SM5 procedures. 


158 


C 


FILE NAMES FOR A MERGE 
MUST BE UNIQUE. 


Duplicate file names exist for 
TO/FROM parameters. 


Eliminate the duplicate 
file names. 


159 


T 


KEY FIELDS OVERLAP 
OTHER KEY FIELDS. 


The same characters in a record 
are included in two or more key 
fields. 


None. 


160 


F 


ALTER OPTION CANNOT 

BE USED FOR OVERLAPPING 

KEY FIELDS. 


When you define your own col- 
lating sequence use the SEQA 
parameter or the SM5SEQA proc- 
edure, you cannot have over- 
lapping key fields. 


Redefine the key fields 
so they do not overtop. 


161 


F 


SUM FIELDS CANNOT OVER- 
LAP OTHER SUM FIELDS 


The same characters in a record 
cannot be included in more than 
one sum field. 


Redefine the sum fields 
so that they do not 
overlap. 
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GLOSSARY 



This glossary defines terms unique to the descrip- 
tion of Sort/Merge; common terms that have special 
connotations within the context of this manual are 
also included. 

Ascending - 

The order of sorting keys so that the record 
having the numeric key with the highest value 
is written last on the output file, and charac- 
ter keys are sorted according to the specified 
collating sequence. See Sort Order. 

ASCII - 

American National Standard Code for Information 
Interchange. An 8-bit code representing a 
prescribed set of 128 characters. Control Data 
operating systems use a 6-bit display code to 
represent a subset (called ASCII6) of these 
characters. 

Basic Access Methods (BAM) - 

• A file manager that processes sequential and 
word addressable file organizations. See CYBER 
Record Manager. 

Beginning-of-Information (BOI) - 

The start of your first record in a file. 
System information, such as tape labels of 
sequential files, can appear before beginning- 
of- information. 

Block - 

A logical or physical grouping of records. 
CYBER Record Manager defines block types I, C, 
K, and E for sequential files. 

Byte - 

A group of bits. In the body of this manual, a 
byte is six bits that represents a single 
character. 

Character - 

A letter, digit, punctuation mark, or mathe- 
matical symbol forming part of one or more of 
the standard character sets. 

Collating Sequence - 

A sequence in which the characters that are 
acceptable to a computer are ordered for 
purposes of sorting, merging, and comparing. 

Control Statement Section - 

The first section of a job; contains the 
sequence of control statements that specifies 
all steps for job execution. 

Control Statement Sort - 

A sort performed on the basis of parameters in 
the S0RT5 control statement and in optional 
directive files. 

CYBER Control Language (CCL) - 

A language that allows you to insert a set of 
statements into the control statement section 
of your job; provides a means for you to 



determine the status of files, initiate tests 
and transfers within the control statement 
section, and display results in your job 
dayfile. 

CYBER Record Manager (CRM) - 

A generic term relating to the common products 
Advanced Access Methods and Basic Access 
Methods that run under the NOS and NOS/BE 
operating systems and that allow a variety of 
record types, blocking types, and file 
organizations to be created and processed. The 
execution time input/output of COBOL, FORTRAN, 
Sort/ Merge, ALGOL, and the DMS-170 products is 
implemented through CYBER Record Manager. The 
input/output of the NOS and NOS/BE operating 
system utilities such as COPY or SKIPF are not 
implemented through CYBER Record Manager. All 
CYBER Record Manager file processing requests 
ultimately pass through the operating system 
input/output routines. 

Default - 

A value supplied by Sort/Merge when you omit a 
specification from a parameter list. 

Descending - 

The order of sorting keys so that the record 
having the numeric key with the lowest value is 
written last on the output file, and character 
keys are sorted in reverse order of the speci- 
fied collating sequence. See Sort Order. 

Dialog - 

An interactive aid designed to guide an in- 
experienced user through a sort or merge 
specification. 

Directive File - 

A file that can be used in a control statement 
sort or merge; contains processing parameters 
in addition to the parameters specified in the 
S0RT5 or MERGE control statement. This file 
must be a sequential file of block type C and 
record type Z. 

Display Code - 

A 6-bit code representing a 63-character or 
64-character computer character set. 

EBCDIC - 

The abbreviation for extended binary-coded 
decimal interchange code. Control Data oper- 
ating systems use a 6-bit version (called 
EBCDIC6) to represent this code. 

End-of-Information (EOI) - 

CYBER Record Manager defines end-of-information 
in sequential files in terms of the file resi- 
dence, as shown in table C-l. 

Entry Point - 

A location within a program that can be refer- 
enced from other programs. Each entry point 
has a unique name with which it is associated. 
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TABLE 0-1. END-0F-INF0RMATION BOUNDARIES 



File 
Organization 


File 
Res idence 


Physical 
Position 


Sequential 


Mass storage 


After the last 
user record. 


Sequential 


Labeled tape 
in SI, I, S, 


After the last 
user record and 




or L format 


before any file 
trai ler labe Is . 


Sequential 


Unlabeled 
tape in SI 


After the last 
user record and 




or I format 


before any file 
trailer labels. 


Sequential 


Unlabeled 
tape in S or 
L format 


Undefined. 



File - 

A collection of records treated as a unit; 
represented by a logical file name and delim- 
ited by beginning-of-information and end-of- 
information. 

FILE Control Statement - 

A control statement that supplies file informa- 
tion table (FIT) values after a source language 
program is compiled or assembled but before the 
program is executed. Basic file characteris- 
tics such as organization, record type, and 
description can be specified in the FILE 
control statement. 

File Information Table (FIT) - 

A table through which your program communicates 
with BAM. All file processing executes on the 
basis of information in the FIT. You can set 
FIT fields directly or use parameters in a file 
access call that sets the fields indirectly. 

Floating-Point Number - 

Numeric data stored internally as binary 
values (corresponds to a FORTRAN REAL or COBOL 
C0MPUTATI0NAL-2 number). 



Graphic - 

A character that can be printed or displayed. 



Integer - 

Numeric data stored internally as a binary 
value rather than a character value; in a 
parameter or procedure call format, a number 
that does not include any character positions 
to the right of the assumed decimal point and 
is not signed. 

Interactive - 

Job processing in which you asnd the system 
communciate with each other, rather than your 
submitting a job and receiving output, having 
no control over the Job while processing occurs. 



Interactive Facility (IAF) - 

The network host software product that allows 
you to enter commands and to communicate with 
an executing program from a time-sharing 
terminal; operates under NOS. 

INTERCOM - 

The software that directs the flow of informa- 
tion and data between the central site Computer 
and a number of remote terminals; operates 
under NOS /BE. 

Job - 

A set of control statements and the data and 
directives used by those control statements. A 
batch job begins with the job, USER, and CHARGE 
statements on NOS and the job and ACCOUNT 
statements on NOS/BE. An interactive job 
begins with login to a terminal. 

Key Type - 

The name of a numeric data format or collating 
sequence . 

Keyword - 

A part of a parameter that you enter exactly as 
shown in the parameter format. It is not 
changed by any information you supply. 

Library - 

A collection of programs or routines that is 
searched by the loader for entry points refer- 
enced by a program. 

Literal - 

A constant completely defined by its own 
identity. 

Local File - 

A file currently assigned to a job, or a 
temporary file other than the primary file; 
often contains a copy of an indirect access 
file or data from a magnetic tape. 

Logical File Name (lfn) - 

The one to seven coded letters or digits by 
which the operating system recognizes a file. 
Every logical file name in a job must be unique 
and begin with a letter. 

Logical Record - 

Under NOS, a data grouping that consists of one 
or more PRUs terminated by a short PRU or 
zero-length PRU. Equivalent to a system- 
logical-record under NOS/BE. 

Login - 

The process used at a terminal to gain access 
to the system. 

Logout - 

The process used to end a terminal session. 

Major Sort Key - 

A sort key that is considered to be the most 
important and is specified first. See Sort 
Key, Minor Sort Key. 

Mass Storage - 

A disk pack or other rotating mass storage 
device; not a magnetic tape. 
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Merge - 

The process of combining two or more presorted 
files. 

Minor Sort Key - 

A sort key that is considered of lesser impor- 
tance and is specified after the most important 
sort key. See Sort Key, Major Sort Key. 

Owncode Routine - 

A subroutine you write that provides the capa- 
bility of inserting, substituting, modifying, 
or deleting input and output records during 
Sort/Merge processing. 

Parameter - 

A variable identified by a keyword and assigned 
specific values in the S0RT5 or MERGE control 
statement or in a directive file; parameters 
and their specified values direct Sort/Merge 
processing. 

Partition - 

CYBER Record Manager defines a partition as a 
division within a file with sequential orga- 
nization. Generally, a partition contains 
several records or sections. Implementation 
of a partition boundary is affected by file 
structure and residence, as shown in table C-2. 

Notice that in a file with W type records, a 
short physical record unit (PRU) of level 
terminates both a section and a partition. 

Physical Record Unit (PRU) - 

Under NOS and NOS/BE, the amount of information 
transmitted by a single physical operation of a 
specified device. The size of a PRU depends on 
the device, as shown in table C-3. 

A PRU that is not full of user data is called a 
short PRU; a PRU that has a level terminator 
but no user data is called a zero-length PRU. 

Procedure - 

A subroutine that returns values through its 
parameters; invoked when the name of the 
procedure is referenced in a CALL or ENTER 
statement. 

Record - 

CYBER Record Manager defines a record as a 
group of related characters. A record or a 
portion thereof is the smallest collection of 
information that can be passed between CRM and 
your program. Eight different record types 
exist, as defined by the RT field of the file 
information table. 

Record Type - 

The term record type can have one of several 
meanings, depending on the context. CYBER 
Record Manager defines eight record types 
established by an RT field in the file infor- 
mation table. Tables output by the loader 
are classified as record types such as text, 
relocatable, or absolute, depending on the 
first few words of the tables. 

Relocatable - 

An object program that can reside in any part 
of central memory. The actual starting address 
is established at load time. 



TABLE C-2. PARTITION BOUNDARIES 





Record 


Block 




Device 


Type 


Type 


Physical Boundary 




(RT) 


(BT) 




PRU 


W 


I 


A short PRU of 


device 






level containing 
a one-word deleted 
record pointing 
back to the last I 
block boundary, 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




w 


C 


A short PRU of 
level containing 
a control word 
with a flag indi- 
cating a partition 
boundary. 




D,F,R, 


C 


A short PRU of 




T.U.Z 




level followed by 
a zero-length PRU 
of level 17g. 




S 


- 


A zero-length PRU 
of level number 17s. 


S or L 


w 


I 


A separate tape 


format 






block containing as 


tape 






many deleted rec- 
ords of record 
length as re- 
quired to exceed 
noise record size, 
followed by a de- 
leted one-word 
record pointing 
back to the last I 
block boundary, 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




w 


c 


A separate tape 
block containing as 
many deleted rec- 
ords of record 
length as re- 
quired to exceed 
noise record size , 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




D.F.T, 


C,K,E 


A tapemark. 




R,U,Z 








S 


- 


A tapemark. 


Any 


_ 


- 


Undefined . 


other 








tape 








format 
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TABLE C-3. PRU SIZES 



TABLE C-4. SECTION BOUNDARIES 



Devi ce 


Size in Number 
of 60-Bit Words 


Mass storage. 

Tape in SI format with 
binary data (NOS/BE only). 

Tape in I format (NOS only). 

Tape in any other format. 


64 
512 

512 
Undefined. 



Result Array - 

A means of passing statistics and results of a 
sort or merge back to a calling procedure. 

Rewind - 

An operation that positions a file at the 
beg inning-of- information. 



Section - 

CYBER Record Manager defines a section as a 
division within a file with sequential orga- 
nization. Generally, a section contains more 
than one record and is a division within a 
partition of a file. A section terminates 
with a physical representation of a section 
boundary, as shown in table C-4. 

The NOS and NOS/BE operating systems equate a 
section with a system-logical-record of level 
through 16g. 

Sequential File - 

A file with records in the physical order in 
which they were written. No logical order 
exists other than the relative physical record 
position. 

Signed Numeric Data - 

Integer data stored internally in display code; 
sorted according to numeric order and sign of 
the integer the display code represents. 

Sort Key - 

A field of information within each record in a 
sort or merge input file that is used to deter- 
mine the order in which records are written to 
the output file. 

Sort Order - 

The order for sorting keys, either ascending or 
descending. 

System-Logical-Record - 

Under NOS/BE, a data grouping that consists 
of one or more PRUs terminated by a short PRU 
or zero-length PRU. These records can be 
transferred between devices without loss of 
structure. Equivalent to a logical record 
under NOS. 



Word 



A group of bits (or 6-bit characters) between 
boundaries imposed by the computer system. A 
word is 60 bits in length (10 characters). 



Device 



PRU 
device 



S or L 
format 
tape 



Any 
other 
tape 
format 



Record 
Type 
(RT) 



D.F.R, 
T.U.Z 



D.F.R, 
T.U.Z 



Block 

Type 

(BT) 



C,K,E 



Physical 
Representation 



A deleted one-word 
record pointing 
back to the last I 
block boundary 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 
At least the con- 
trol word is in 
a short PRU of 
level 0. 

A control word with 
flags indicating a 
section boundary. 
The control word 
is in a short PRU 
of level 0. 

A short PRU with a 
level less than 

Undefined. 



A separate tape 
block containing 
as many deleted 
records of record 
length as re- 
quired to exceed 
noise record size, 
followed by a de- 
leted one-word 
record pointing 
back to the last I 
block boundary, 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 

A separate tape 
block containing 
as many deleted 
records of record 
length as re- 
quired to exceed 
noise record size, 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 

Undefined. 



Undefined. 



Undefined. 
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SORT/MERGE PARAMETER SUMMARY 



The format specifications for all parameters used 
in a SORTS or a MERGE control statement are sum- 
marized and listed in this appendix. Detailed 
information for each parameter is referenced by 
page number and appears in section 3 of this manual. 

The following abbreviations are used in this 
appendix: 



char 


character 


expr 


expression 


lfn 


logical file name 


proc 


procedure name 


rep 


repetition 



DIALOG Parameter 

DIALOG=YES (or DIA=Y) 
DIALOG=NO (or DIA=N) 



Page 
3-4 



FROM Parameter 
FROM=lfn 

FROM=(lfn 1 ,lfn 2> ...) 
FROM=$NULL 

KEY Parameter 
KEY= 



l~(key_def [ ,key_def ]...)" 
L range 



where : 



Page 
3-2 



3-2 



[range 
(range[,type [,ad]]) 
(first, length [.type [,ad]]). 



range = Tfirst "| 
[.first.. last J 



DIR Parameter 
DIR=lfn 
DIR=(lfn 1 ,lfn 2 ,...) 



3-3 



L Parameter 
L-lfn 
L=$NULL 



3-3 



E Parameter 
E=lfn 
E=$NULL 

EL Parameter 
EL-T 
EL=W 
EL-F 
EL=C 

ENR Parameter 
ENR=expr 
ENR=expr . . expr 



3-4 



3-4 



3-4 



OWNF Parameter 
0WNF=lfn 

OWNFL Parameter 
OWNFL=integer 
OFL=integer 

OWNMRL Parameter 
OWNMRL=integer 
OMRL=integer 

OWNn Parameter 
OWNn=proc 



3-4 



3-5 



3-5 



3-5 



FASTIO Parameter 

FASTIO=YES (or FASTIO=Y) 
FASTIO=NO (or FASTIO=N) 



3-9 RETAIN Parameter 

RETAIN=YES (or RET=Y) 
RETAIN=NO (or RET=N) 
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D-l 



SEQx Parameters 

SEQN=name 

SEQS=( 'char ' , . . . , 'char ' ) 



[SEQR=YES OR SEQR=Y] 
[SEQA=YES OR SEQA-Y] 



| STATUS Parameter 

STATUS=variable (or ST=variable) 



Page 
3-5 



Page 



SUM Parameter 
| SUM=((sum_def)[,(sumjief )]...) 



3-7 



3-8 



where : 
sum def= 

TO Parameter 
TO=lfn 
TO=$NULL 



VERIFY Parameter 

VERIFY=YES (or VER=Y) 
VERIFY=NO (or VER=N) 



[(first,length,type[,rep])"| 
(first.. last, type[, rep]) J 



3-2 



3-9 
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INTERACTIVE DIALOG 



This appendix contains the text of the interactive indicated by uppercase letters. The answers you 

dialog (figure E-l) that is invoked when you spec- supply are indicated by lowercase letters; "next" 

ify DIALOG=YES. (Your terminal must be in normal or a number following an answer indicates the next 

mode; enter NORMAL before entering the S0RT5 or question that is asked by Sort/Merge. For 

MERGE command. If you are already in the dialogue, questions requiring yes or no answers, you can 

enter a control-T to return to the operating abbreviate and use y or n. 



system). The questions asked by Sort/Merge are 



IS YOUR TERMINAL ALREADY SET TO NORMAL MODE OR UPPERCASE ASCII MODE. ALSO, ARE YOU SURE THAT ALL YOUR 
FILES (IF ANY) ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE CONTROL STATEMENTS SPECIFIED FOR 
THEM 
yes (1) 
no (next) 

UNLESS YOU SPECIFY OTHERWISE, ALL INPUT FILES AND THE OUTPUT FILE ARE ASSUMED TO HAVE STANDARD UNIT 
RECORD FORMAT SUCH AS LINES TYPED FROM A TERMINAL, LINES IN A BATCH JOB, OR LINES TO BE PRINTED ON A 
PRINTER OR TERMINAL. THESE ARE TECHNICALLY KNOWN AS BT=C, RT=Z, FL=N WITH N NO MORE THAN 150. DO YOU 
HAVE ANY FILES THAT ARE NOT OF THIS FORMAT? 
yes (next) 
no (1) 

FOR EACH FILE THAT IS NOT OF THIS FORMAT YOU MUST HAVE SPECIFIED A FILE CONTROL STATEMENT. SORT/MERGE 
WILL QUIT NOW SO YOU MAY DO SO. 

1 . DO YOU HAVE JUST ONE INPUT FILE AND NO 0WN1 OR 0WN2 SUBROUTINES? 
yes (next) 

no (6) 

2. WHAT IS THE NAME OF YOUR INPUT FILE? 
f i le-name 

3. DO YOU HAVE ANY 0WN3 OR 0WN4 SUBROUTINES? 
yes (9) 

no (next) 

4. WHAT IS THE NAME OF YOUR OUTPUT FILE? 
f i Le-name 

5. THE STANDARD COLLATING SEQUENCE IS ASCII6. HERE IS THE WHOLE ASCH6 COLLATING SEQUENCE LISTED 

!■'#$%&■ ()*+,-. /01 23456789: ;<=>?3ABCDEFGHIJKLMN0PQRSTUVWXYZC\:^_ 
DO ALL OF YOUR KEYS CONSIST OF CHARACTER DATA TO BE SORTED ACCORDING TO THE ASCII6 COLLATING 
SEQUENCE? 
yes (next) 
no (12) 

ASCENDING ORDER OF THE ASCII6 COLLATING SEQUENCE MEANS THE NORMAL ORDER. 

!"#$%&' ()*+,-. /0123456789:;<=>?aABCDEFGHIJKLMNOPQRSTUVWXYZC\J^_ 
DESCENDING ORDER MEANS THE REVERSE ORDER. 

_^3\CZYXWVUTSRQP0NMLKJIHGFEDCBAa?>=<;:9876543210/.-,+*)('8%$#"! 
DO YOU WANT ALL YOUR KEYS SORTED IN ASCENDING ORDER? 
yes (next) 
no (next) 

33. HOW MANY KEY FIELDS DO YOU HAVE? 
number 

WHAT IS THE TYPE OF THE MOST IMPORTANT KEY FIELD? 
key-type 

THE LEFT-MOST CHARACTER OF A RECORD IS NUMBER 1. FOR THE MOST IMPORTANT KEY FIELD, WHAT IS THE 

NUMBER OF THE LEFT-MOST CHARACTER? 

number 

HOW MANY CHARACTERS ARE IN THE MOST IMPORTANT KEY FIELD? 

number 
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DO YOU WANT THIS KEY FIELD SORTED IN ASCENDING ORDER?t 
yes (next) 
no (next) 

FOR THE SECONDttMOST IMPORTANT KEY FIELD, WHAT IS THE TYPE OF THE KEY? 
key-type 

FOR THE SECOND^ MOST IMPORTANT KEY FIELD, WHAT IS THE NUMBER OF THE LEFT-HOST CHARACTER? 
number 

HOW MANY CHARACTERS ARE IN THE SECONDttMOST IMPORTANT KEY FIELD? 

number 

DO YOU WANT RECORDS WITH EQUIVALENT KEY VALUES TO BE WRITTEN IN THE SAME ORDER THEY ARE READ? 
yes (next) 
no (next) 

A SUM FIELD IS A ^SPECIAL AFIELD IN A RECORD THAT IS CHANGED BY SORT7MERGE. IF "SUN FIELDS ARE 
SPECIFIED SUM FIELDS FROM RECORDS WITH EQUAL KEY VALUES WILL BE NUMERICALLY SUMMED AND PUT IN THE 
SAME SUM FIELD IN A NEW RECORD. THE REMAINING KEY AND DATA FIELDS IN THE NEW RECORD WILL BE SET TO 
THE CORRESPONDING FIELDS IN ONE OF THE OLD RECORDS. THE ORIGINAL RECORDS WILL BE DELETED. RECORDS 
MAY HAVE MORE THAN ONE SUM FIELD, AND THEY WILL BE SORTED ACCORDING TO KEY VALUES. THEY TYPE OF A 
SUM MAY BE ANY NUMERIC KEY TYPE EXCEPT REAL. 

28. HOW MANY SUM FIELDS DO YOU HAVE? 
number 

WHAT IS THE TYPE OF THE FIRSTttsUM FIELD? 
sum-type 

WHAT IS THE FIRST CHARACTER IN THE FIRSTttsUM FIELD? 
number 

HOW MANY CHARACTERS* LONG IS THE FIRSTttsUM FIELD? 

number x 

GIVE AN ESTIMATE OF THE MAXIMUM NUMBER OF RECORDS TO BE SORTED, 
number (end of dialog) 

6. DO YOU HAVE AN OWN1 SUBROUTINE? 
yes (next) 

no (7) 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S)? 
f i Le-narae 

WHAT IS THE NAME OF YOUR OWN1 SUBROUTINE? 
entry-name 

7. DO YOU HAVE AN 0WN2 SUBROUTINE? 
yes (next) 

no (8) 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S)?M 
f i le-name 

8. HOW MANY INPUT FILES DO YOU HAVE? 
1 (2) 

number (next) 

WHAT IS THE NAME OF YOUR FIRST tt INPUT FILE? 
f i le-name 

9. WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE(S)?tt 
f i le-name 

DO YOU HAVE AN OWN3 SUBROUTINE? 
yes (next) 
no (10) 
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WHAT IS THE NAME OF YOUR 0WN3 SUBROUTINE? 
entry-name 

00 YOU HAVE AN 0UN4 SUBROUTINE? 
yes (next) 
no (11) 

10. WHAT IS THE NAME OF YOUR 0WN4 SUBROUTINE? 
entry-name 

11. 00 YOU HAVE AN OUTPUT FILE? 
yes (4) 

no (5) 

12. 00 YOU KNOW THE NAMES OF THE KEY TYPES YOU WANT TO USE? 
yes (33) 

no (next) 

DO YOUR RECORDS CONSIST ENTIRELY OF CHARACTERS? 
yes (19) 
no (next) 

NON-CHARACTER DATA HAY BE ORDERED ACCORDING TO ITS BINARY (SIGNED OR UNSIGNED) VALUE, OR REAL (I.E. 
FLOATING POINT) VALUE. 

A SIGNED BINARY KEY INTERPRETS THE BITS WITHIN THE KEY FIELD AS A ONE'S COMPLEMENT BINARY NUMBER. 
IF THE LEFT-MOST BIT IS ZERO THEN THE NUMBER IS POSITIVE. IF THE LEFT-MOST BIT IS ONE THEN THE 
NUMBER IS NEGATIVE AND THE MAGNITUDE OF THE NUMBER IS THAT WITH ALL BITS COMPLEMENTED. IF THE KEY 
FIELD STARTS AND ENDS ON A CHARACTER BOUNDARY THEN THE KEY TYPE IS "INTEGER", OTHERWISE IT IS 
"INTEGER_BITS". 

AN UNSIGNED BINARY KEY INTERPRETS THE BITS WITHIN THE KEY FIELD AS A BINARY NUMBER. THE LEFT-MOST 
BIT IN THE FIELD CONTRIBUTES TO THE NUMERIC VALUE JUST LIKE ANY OTHER BIT IN THE FIELD. IF THE KEY 
FIELD STARTS AND ENDS ON A CHARACTER BOUNDARY THEN THE KEY TYPE IS "BINARY", OTHERWISE IT IS 
"BINARY_BITS". 

A REAL OR FLOATING POINT KEY INTERPRETS A 60-BIT VALUE AS A STANDARD FLOATING POINT NUMBER. THE KEY 
TYPE IS "REAL". 

13. IF YOU WANT MORE INFORMATION ABOUT A KEY TYPE, INCLUDING HOW TO SPECIFY IT, TYPE THE NAME OF THE KEY 
TYPE. (OTHERWISE, TYPE A SPACE.) 

binary (14) 
binary_bits (15) 
integer (16) 
integerjaits (17) 
real (18) 
A (19) 

14. A BINARY KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE LENGTH OF THE FIELD. 
(THE FIRST CHARACTER POSITION IN THE RECORD IS 1.) 

(13) 

15. A BINARY_BITS KEY FIELD IS SPECIFIED BY NAMING THE FIRST BIT POSITION AND THE LENGTH OF THE FIELD. 
(THE FIRST BIT POSITION IN THE RECORD IS 1.) 

(13) 

16. AN INTEGER KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE LENGTH OF THE 
FIELD. (THE FIRST CHARACTER POSITION IN THE RECORD IS 1.) 

(13) 

17. AN INTEGER_BITS KEY FIELD IS SPECIFIED BY NAMING THE FIRST BIT POSITION AND THE BIT LENGTH OF THE 
FIELD. (THE FIRST BIT POSITION IN THE RECORD IS 1.) 

(13) 

18. A REAL KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE 
FIELD. SINCE REAL KEY FIELDS MUST BE FULL WORDS AND ALIGNED ON WORD BOUNDARIES, THE FIRST CHARACTER 
POSITION MUST SPECIFY THE FIRST CHARACTER OF A WORD AND THE LENGTH MUST BE 10.* 

(13) 
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19. KEY FIELDS CONSISTING ONLY OF CHARACTERS NAY BE ORDERED ACCORDING TO A CHARACTER COLLATING SEQUENCE 
OR ACCORDING TO A NUMERIC INTERPRETATION OF THE CHARACTERS. 

DO YOU WANT ANY OF YOUR CHARACTER KEY FIELDS TO BE INTERPRETED NUMERICALLY? 
yes (next) 
no (27) 

THE KEY TYPE FOR NUMERIC CHARACTER KEYS IS "NUNERlCJCX" WHERE XX INDICATES HOW THE SIGN (IF ANY) IS 

TO BE EXTRACTED AND WHETHER LEADING BLANKS ARE ALLOWED. THE LEGAL NUMERIC CHARACTER KEY TYPES ARE: 

NUMERIC NS ALL DIGITS, NO SIGN 

NUMERIC_FS LEADING BLANKS, THEN OPTIONAL NEGATIVE SIGN, THEN DIGITS 

NUMERIC LS REQUIRED SIGN IS FIRST, THEN DIGITS 

NUMERICJTS DIGITS FOLLOWED BY REQUIRED SIGN 

NUMERICJ-0 LEADING OVERPUNCHED DIGIT, THEN DIGITS 

NUNERIC_TO DIGITS FOLLOWED BY TRAILING OVERPUNCHED DIGIT 

20. IF YOU WANT MORE INFORMATION ABOUT ONE OF THE NUMERIC CHARACTER KEY TYPES, INCLUDING HOW TO SPECIFY 
IT, TYPE THE TOME OF THE KEY TYPE. (OTHERWISE, TYPE A SPACE.) 

numeric_ns (21) 
numeric_fs (22) 
numeric_Ls (23) 
numeric_ts (24) 
numei-i c_lo (25) 
numeric_to (26) 
A (27) 

21. NUMERIC_NS KEY FIELDS MUST CONTAIN ALL DECIMAL DIGIT CHARACTERS WITHOUT A SIGN. THE FIELD IS 
SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

22. NUMERIC_FS KEY FIELDS MUST BE NUMERIC CHARACTERS IN A FLOATING SIGN FORMAT. LEADING BLANKS ARE 
REQUIRED FOR LEADING ZEROS, FOLLOWED BY AN OPTIONAL SIGN CONSISTING OF "-", FOLLOWED BY DECIMAL 
DIGIT CHARACTERS. THIS IS THE SAME FORMAT AS IS PRODUCED BY WRITING ACCORDING TO THE DEFAULT 
FORTRAN I FORMAT WITH NO MODIFIERS. THE FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION 
AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

23. THE FIRST CHARACTER OF A NUMERIC LS KEY FIELD MUST BE A "+" OR "-" CHARACTER. THE REMAINING 
POSITIONS MUST CONSIST OF DECIMAL DIGIT CHARACTERS. THE FIELD IS SPECIFIED BY NAMING THE FIRST 
CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

24. THE TRAILING (RIGHT-MOST) CHARACTER OF A NUMERIC TS KEY FIELD MUST BE A "+" OR "-" CHARACTER. THE 
REMAINING POSITIONS MUST CONSIST OF DECIMAL DIGIT CHARACTERS. THE FIELD IS SPECIFIED BY NAMING THE 
FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

25. THE LEADING (LEFT-MOST) CHARACTER OF A NUMERlC_LO KEY FIELD MUST BE AN OVERPUNCHED DIGIT. THE 
OVERPUNCHED DIGIT DETERMINES BOTH THE SIGN OF THE ENTIRE NUMBER AND THE VALUE OF THE LEADING DIGIT. 
CHARACTERS FROM "0" TO "9" MEAN THE SIGN IS POSITIVE AND THE LEADING DIGIT IS TO 9. CHARACTERS 
FROM "A" TO "I" MEAN THE SIGN IS POSITIVE AND THE LEADING DIGIT IS 1 to 9. CHARACTERS FROM "J" TO 
"R" MEAN THE SIGN IS NEGATIVE AND THE LEADING DIGIT IS 1 TO 9. THE CHARACTER "<" MEANS THE SIGN IS 
POSITIVE AND THE LEADING DIGIT IS 0. THE CHARACTER "!" MEANS THE SIGN IS NEGATIVE AND THE LEADING 
DIGIT IS ZERO. THE REMAINING POSITIONS OF THE FIELD MUST CONTAIN DECIMAL DIGITS. THE FIELD IS 
SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

26. THE TRAILING (RIGHT-MOST) CHARACTER OF A NUMERIC TO KEY FIELD MUST BE AN OVERPUNCHED DIGIT. THE 
OVERPUNCHED DIGIT DETERMINES BOTH THE SIGN OF TH? ENTIRE NUMBER AND THE VALUE OF THE TRAILING 
DIGIT. CHARACTERS FROM "0" TO "9" MEAN THE SIGN IS POSITIVE AND THE TRAILING DIGIT IS TO 9, 
CHARACTERS FROM '"A" TO "I" MEAN THE SIGN IS POSITIVE AND THE TRAILING DIGIT IS 1 TO 9. CHARACTERS 
FROM "J" TO "R" MEAN THE SIGN IS NEGATIVE AND THE TRAILING DIGIT IS 1 TO 9. THE CHARACTER "<" MEANS 
THE SIGN IS POSITIVE AND THE LEADING DIGIT IS 0. THE CHARACTER "!" MEANS THE SIGN IS NEGATIVE AND 
THE TRAILING DIGIT IS ZERO. THE REMAINING POSITIONS OF THE FIELD MUST CONTAIN DECIMAL DIGITS. THE 
FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 
(20) 
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27. DO YOU WANT ANY OF YOUR CHARACTER KEYS TO BE ORDERED ACCORDING TO A COLLATING SEQUENCE? 
yes (next) 
no (32) 

THE STANDARD COLLATING SEQUENCE IS ASCII6. HERE IS THE WHOLE ASCII6 COLLATING SEQUENCE LISTED 
!"#$«■()*+,-. /0123456789:;<=>?8ABCDEFGHIJKLHNOPQRSTUVWXYZC\]*_ 

THE KEY TYPE OF A CHARACTER KEY FIELD ORDERED ACCORDING TO A COLLATING SEQUENCE IS THE NAME OF THE 
COLLATING SEQUENCE. THE KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE 
LENGTH OF THE FIELD. 

THERE ARE FIVE PRE-DEFINED COLLATING SEQUENCES: DISPLAY, C0B0L6, ASCII6, EBCDIC6 AND INTBCD. THERE 
CAN BE FROM TO 100 USER-DEFINED COLLATING SEQUENCES. 
DO YOU WANT TO DEFINE YOUR OWN COLLATING SEQUENCE? 
yes (next) 
no (32) 

29. WHEN ASKED TO TYPE IN YOUR COLLATING SEQUENCE PLEASE TYPE IT IN AS C,C,C,C,C,C OR C,C,C,C, 

C,C 
WHERE C IS A CHARACTER OR OCTAL VALUE. 

C CAN BE A LETTER, A ONE-DIGIT NUMBER OR A SPECIAL CHARACTER SUCH AS ( ) + - *. 

SORT/MERGE ASSUMES A TWO-DIGIT NUMBER IS AN OCTAL VALUE. (THE NUMBER SHOULD NOT BE FOLLOWED BY A 
LETTER "B".) THE COMMA HAS TO BE SPECIFIED BY ITS OCTAL VALUE 56. HOW MANY COLLATING SEQUENCES DO 
YOU WANT TO DEFINE? 
number 

30. WHAT IS THE NAME OF YOUR COLLATING SEQUENCE? 
sequence-name 

PLEASE TYPE IN YOUR COLLATING SEQUENCE. 

(30 if more to define) 
(next if done defining) 

DEFINING EQUATE MEANS SPECIFYING TWO OR MORE CHARACTERS ALREADY IN A COLLATING SEQUENCE AS EQUAL FOR 

COMPARISON PURPOSES. MORE THAN ONE EQUATE COLLATING SEQUENCE MAY BE SPECIFIED FOR A COLLATING 

SEQUENCE. 

DO YOU WANT TO DEFINE EQUATES FOR YOUR COLLATING SEQUENCES? 

yes (next) 

no (32) 

WHEN ASKED TO TYPE IN YOUR EQUATE SEQUENCE(S), PLEASE ENTER IN THE FORM C,C,C,C,C,C WHERE C IS A 
CHARACTER OR OCTAL VALUE AS EXPLAINED BEFORE. 
HOW MANY EQUATE SEQUENCES DO YOU WANT TO DEFINE? 
number 

31 . WHAT IS THE NAME OF THE COLLATING SEQUENCE FOR THIS EQUATE? 

sequence-name 

PLEASE TYPE IN YOUR EQUATE SEQUENCE. 

(31 if more to define) 
(next if done defining) 

32. YOU SHOULD KNOW THE NAME(S) OF ALL KEY TYPES YOU WANT TO USE. IF YOU DO NOT KNOW, START OVER BY 
TYPING "RESTART" INSTEAD OF THE NUMBER OF KEY FIELDS. 

(33) 



'Not asked if you answered "yes" to the previous question about sort order. 
■'Repeated with successive numbers until all have been specified. 

t"BITS" if you specified sum type INTEGER_BITS or BINARY_BITS. 
■f-i-Not asked if you gave the f i le name in response to question 6. 
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SORT/MERGE 5, SORT/MERGE 4 COMPARISON 



Sort/Merge 5 is functionally equivalent to 
Sort /Merge 4, but these versions of the product are 
externally incompatible because the control state- 
ment for Sort/Merge 5 has been changed. Table F-l 
shows a comparison of Sort/Merge 5 and Sort/Merge 
4. As indicated in table F-l, the Sort /Merge 4 
FORTRAN procedures can be called by Sort/ Merge 5 
users, and the Sort/Merge 4 owncode exits can be 
taken from FORTRAN 5. 



Since Sort/Merge 5 procedures are compatible with 
Sort/Merge 4 FORTRAN procedures, no changes are 
needed to convert programs calling Sort/Merge 4 
FORTRAN procedures FORTRAN compatible owncode 
routines can be called by Sort/Merge 4 FORTRAN 
procedures or by Sort/Merge 5 without any changes 
to the owncode routines. All these Sort/Merge 5 
relocatable binaries can be run by including LDSET 
(LIB=SRT5LIB) in the load sequence before program 
execution. 



TABLE F-l. SORT/MERGE 5, SORT/MERGE 4 COMPARISON 



Feature 



Sort/Merge 5 



Sort/Merge 4 



Control 

Statement 

Sort 

Merge 

Key Types 



Collating 
Sequences 



Record 
Types 

Tape Sorts 



Checkpoint/ 
Restart 



Interactive 
Usage 

Procedure 
Calls 



Owncode 
Routines 



COBOL 



Most sorts can be specified with the S0RT5 
control statement and parameters alone. 



Merge-only processing is available. 

Sort keys can be 6-bit display code charac- 
ters, signed or unsigned binary integers, 
or floating-point numbers. 



ASCII6 (default), C0B0L6, DISPLAY, EBCDIC6, 
and INTBCD are predefined. User-defined is 
also available. 



Any CYBER Record Manager sequential record 
type except U can be sorted. 

Tape files can be used as FROM and TO 
files, but balanced and polyphase sorting 
is not performed. Tape scratch files for 
intermediate files is not supported. 

Not available. 



Interactive dialog and commands are avail- 
able to aid in sort or merge specification. 

Sort or merge can be initiated from within 
a program (FORTRAN or other language) by a 
series of procedure calls. 



Routines can be written to process input 
records, output records, or records with 
equal keys during Sort/Merge processing. 



C0B0L5 control statement option can specify 
Sort/Merge 5 be used when COBOL SORT or 
MERGE statement is executed, or direct 
calls to the procedures can be made. 



A control statement sort requires a separate 
directives section of the input file. 



Merge— only processing is available. 

Sort keys can be 6-bit characters written in 
display code or internal BCD code, signed or 
unsigned binary integers , or floating-point 
numbers. 

ASCII6 (default if installation character 
set is ASCII), C0B0L6 (default if installa- 
tion character set is CDC), DISPLAY, and 
INTBCD are predefined. User-defined is 
also available. 

Any CYBER Record Manager sequential record 
type except U can be sorted. 

A tape variant provides balanced and poly- 
phase tape sorting. 



A job abnormally terminated can be captured 
on tape so that the job can be restarted 
from the checkpoint, rather than from the 
beginning. 

No interactive dialog or commands are 
available. 

Sort or merge can be initiated from within 
a COMPASS or FORTRAN program by a series of 
procedure calls. The Sort/Merge 4 FORTRAN 
procedures can be called by Sort/Merge 5 
users. 

Routines can be written to process input 
records, output records, records with equal 
keys, or nonstandard labels during Sort/ 
Merge processing. The Sort/Merge 4 FORTRAN 
owncode exits can be taken by Sort/Merge 5 
users . 

The interface is through the COBOL SORT or 
MERGE statement; Sort/Merge 4 is the default 
for sorts or merges from COBOL 5. 
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F-l 



INDEX 



Alter 

SEQA parameter 3-7 
SM5SEQA procedure 5-5 
Ascending (see Sort order) 
ASCII6 (see Collating sequence) 



Basic Access Methods (BAM) 3-1, 3-10, C-l 
Batch processing 1-2 
Beginning-of-information (BOI) C-l 
BINARY (see Numeric data formats) 
BINARY_BITS (see Numeric data formats) 
Bit 2-1 

Blanks (see Spaces) 
Block 

Definition C-l 

Types 3-11 
Byte 2-1, C-l 



CALL statement 5-1 
Character 

Data 2-1 

Definition C-l 

Sets A-l 
COBOL 

Control statement 1-2, 6-1 

Sort/Merge procedures 6-1 
C0B0L6 (see Collating sequence) 
Collating sequence 

ASCII6 2-2 

C0B0L6 2-2 

Definition 1-1, 2-2, C-l 

DISPLAY 2-2 

EBCDIC6 2-2 

INTBCD 2-2 

User-defined 

SEQx parameters 3-5 
SM5SEQx procedures 5-4 
Commas 3-1, 3-9, 4-5 
Configuration 

Hardware 1-2 

Software 1-2 
Continuation lines 3-1 
Control statement (see FILE control statement, MERGE 

control statement, S0RT5 control statement) 
CYBER Control Language (CCL) 

Definition C-l 

ENR parameter 3-4 

STATUS parameter 3-7 
CYBER Record Manager (CRM) 1-1, C-l 



Data alignment 2-1 
Dayfile messages 5-4 
Default 

Definition C-l 

File characteristics 1-1, 3-11 
Descending (see Sort order) 
DIA parameter (see DIALOG parameter) 
Diagnostics B-l 
Dialog (see Interactive dialog) 



DIALOG parameter 3-2, 3-4, 4-2, D-l 
DIR parameter 3-3, D-l 
Directive files 

Continuation 3-2 

Definition 1-1, C-l 

DIR parameter 3-3 

Example 8-4 

Format 3-1 

Length 3-1 

Use 1-1, 3-1, 8-4 
DISPLAY (see Collating sequence) 
Display code C-l 
Duplicate parameters 3-2 



E parameter 3-4, D-l 

EBCDIC6 (see Collating sequence) 

EL parameter 3—4, D-l 

End-of-file 3-2, 5-2 

End-of-information (EOI) C-l 

End-of-record 3-2, 5-2 

ENR parameter 3-4, D-l 

ENTER statement 6-1 

Entry point C-l 

Error 

Codes 

SM5ST procedure 5-5 
STATUS parameter 3-7 
Level 3-4, 5-3, B-l 
Messages B-l 
Status variable 

SM5ST procedure 5-5, B-l 
STATUS parameter 3-7, B-l 
Equal keys 

Owncode 5 7-4 
RETAIN parameter 3-5 
SM5RETA procedure 5-4 
Summing 

SM5SUM procedure 5— b 
SUM parameter 3-8 
Examples 

Control statement merge 8-3 
Control statement sort 
Multiple keys 8-3 
One key 8-1 
Directive file 

Creation 8-4 
Use 8-4 
Interactive commands 4—4 
Interactive dialog 8-1 
Interactive parameter specification 
NOS login 4-1 
NOS/BE login 4-2 
Output file disposition 4-4 
Owncode routine 8-9 
Procedure calls 8-7 
EXTERNAL statement 5-4, 7-1 



FASTIO parameter 3-9, D-l 

Features 1-1 

Field length requirements 3-11 



4-5 



60484800 D 



Index- 1 



3-10 



File 

Definition C-2 

Description 1-1, 

Format 

Data file 3-2, 5-2 
Directive file 3-1 
Error file 3-4, 5-3 
Listing file 3-3 

Local C-2 

Organization 3-10 
FILE control statement 

Description 1-1, 3-10, C-2 

DIR parameter 3-3 

FASTIO parameter 3-9 

Format 3-10 

FROM parameter 3-2 

Interactive 4-3, 4-4 

L parameter 3-3 

Owncode routine 7-1 

SM5E procedure 5-3 

SM5FAST procedure 5-4 

SM5FROM procedure 5-2 

SM5T0 procedure 5-2 

TO parameter 3-2 
File information table (FIT) 3-10, C-2 
Floating-point numbers 2-5, C-2 
FORTRAN programs 1-1, 5-1, 7-1 
FROM parameter 3-2, D-l 



Graphic A-l, C-2 



L parameter 3-3, D-l 
Leading blanks 2-2 
Library C-2 
Listing file 3-3 
Literal C-2 
Loading 

Owncode routines 3-5, 5-4 

Procedures 5-1 
Logical file name (lfn) C-2 
Logical record C-2 
Login 4-1, C-2 
Logout 4-5, C-2 



Major sort key 2-1 , C-2 
Mass storage C-2 
MERGE control s t at ement 

Continuation 

Format 3-1, 

Length 3-1, 

Punctuation 
Merge order 3-9 
Merging 

Control statement 3-1 

Definition C-3 

Initiation 1-1, 5-6 

Procedure call 5-1 

Purpose 1-1 
Minor sort key 2-1, C-3 
Multiple sort keys 2-1 



3-1. 


, 4-5 


4-5 




4-5 




3-1, 


4-5 



HELP command 4-3 



Input files 

FROM parameter 3-2 

Owncode routine processing 7-3 

SM5FR0M procedure 5-2 
INTBCD (see Collating sequences) 
Integer C-2 

INTEGER (see Numeric data formats) 
INTEGER_BITS (see Numeric data formats) 
Interactive commands 4-3 
Interactive dialog 

Text E-l 

Use 1-1, 4-2, 8-1 
Interactive processing 1-2, 4-1, C-2 
INTERCOM 1-2, C-2 
Internal representation 2-2 



Job 



Definition C-2 
Flow 

Batch 1-3 

Interactive 1-4 
Structure 

Control statement merge 8-3, 8-4 

Control statement sort 8-3 

Directive file use 8-7 

Procedure calls 8-7 



KEY parameter 3-2, D-l 
Keys (see Sort keys) 
Keyword 

Definition C-2 

Sort/Merge parameters 3-2 



Network Access Method (NAM) 1-2 

Noncharacter data 2-1 

NOS 1-2 

NOS/BE 1-2 

Notations ix 

Numeric data formats 

BINARY 2-4 

BINARY_BITS 2-4 

INTEGER 2-4 

INTEGER_BITS 2-4 

NUMERIC_FS 2-4 

NUMERIC_LO 2-4 

NUMERIC_LS 2-4 

NUMERICJJS 2-4 

NUMERICJTO 2-4 

NUMERICJTS 2-4 

REAL 2-4 
NUMERIC_FS (see Numeric data formats) 
NUMERIC_LO (see Numeric data formats) 
NUMERIC_LS (see Numeric data formats) 
NUMERICJJS (see Numeric data formats) 
NUMERICJTO (see Numeric data formats) 
NUMERIC TS (see Numeric data formats) 



OFL parameter (see OWNFL parameter) 
OMRL parameter (see OWNMRL parameter) 
Order (see Sort order) 
Output files 

Owncode routine processing 7-4 

SM5T0 procedure 5-2 

TO parameter 3-2 
Overflow 

SM5SUM procedure 5-6 

SUM parameter 3-8 
Overpunch character representation 2-5 



Index-2 
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Owncode routines 

Calling sequence 3-5 

Definition 1-2, 7-1, C-3 

File 3-5 

Loading 3-5, 7-1 

Name 3-5, 5-4 

Owncode 1 7-2 

Owncode 2 7-3 

Owncode 3 7-3 

Owncode 4 7-4 

Owncode 5 7-4 

Parameters 7-1 

Record length 3-5, 5-4 

Summary 7-2 
OWNF parameter 3-4, 7-1, D-l 
OWNFL parameter 3-5, 7-1, D-l 
OWNMRL parameter 3-5, D-l 
OWNn parameter 3-5, 7-1, D-2 



Parameter 

Definition C-3 

Owncode routine 7-1 

Sort/Merge 3-2, D-l 
Partition C-3 
Periods 3-1 

Physical record unit (PRU) C-3 
Positional parameters 3-2, 3-10 
Procedure calls 

Definition 1-1, C-3 

Loading 5-1 

Order 5-1 

Owncode routines 7—1 

Record length 5-1 

Result array 5-1 
Punctuation (see Commas, Periods, Spaces) 



QUIT command 4-3 



Range ix, 3-1, 3-7 

REAL (see Numeric data formats) 

Reca parameter 7-1 , 7-2 

Recb parameter 7—1, 7—2 

Record 

Definition C-3 

Estimated number 

ENR parameter 3-4 
SM5ENR procedure 5-3 

Length 

Owncode routine 3-5, 5-4 
Specification 3-11, 5-1 

Type 1-1, 3-11, C-3 
Relocatable C-3 
Resource map 3-3 
RESTART command 4-3 
Result array 5-1, C-4 
RET parameter (see RETAIN parameter) 
RETAIN parameter 3-5, D-2 
Return_code parameter 7-1 
Rewind C-4 
REWIND statement 5-2 
Rla parameter 7-1 
Rib parameter 7-1 



7-1 



5-5 
5-5 
5-5 
5-5 



Section C-4 
Sequential file 



3-11, C-4 



SEQx parameters 

SEQA parameter 3-7, D-2 
SEQN parameter 3-5, D-2 
SEQR parameter 3-7, D-2 
SEQS parameter 3-6, D-2 
Signed numeric data 2-2, C-4 
SM5E procedure 5-3 
SM5EL procedure 5-3 
SM5END procedure 5-7 
SM5ENR procedure 5-3 
SM5FAST procedure 5-4 
SM5FR0M procedure 5-2 
SM5KEY procedure 5-2 
SM5MERG procedure 5-2 
SM5N0DA procedure 5-4 
SM50FL procedure 5-4 
SM50MRL procedure 5-4 
SM50WNn procedure 5-4, 
SM5RETA procedure 5-4 
SM5SEQx procedures 

SM5SEQA procedure 
SM5SEQN procedure 
SM5SEQR procedure 
SM5SEQS procedure 
SM5S0RT procedure 5-1 
SM5ST procedure 5-5 
SM5SUM procedure 5-6 
SM5TO procedure 5-2 
Sort keys 

Definition 1-1, 2-1, C-4 
Key length 

General 2-1 
KEY parameter 3-2 
SM5KEY procedure 5-2 
Key position 

General 2-1 
KEY parameter 3-2 
SM5KEY procedure 5-2 
Key type 

General 2-1, C-2 
KEY parameter 3-2 
SM5KEY procedure 5-2 
Size 2-i 
Sort/Merge 4 F-l 
Sort order 
Ascending 

KEY parameter 3-2 
SM5KEY procedure 5-2 
Definition 2-5, C-4 
Descending 

KEY parameter 3-2 
SM5KEY procedure 5-2 
Sorting 

Control statement 3-1 
Initiation 1-1, 5-6 
Procedure call 5-1 
Purpose 1-1 
S0RT5 control statement 

Continuation 3-1 , 4-5 
Format 3-1, 4-5 
Length 3-1, 4-5 
Punctuation 3-1, 4-5 
Spaces 3-1 , 4-5 

ST parameter (see STATUS parameter) 
STATUS parameter 3-7, D-2 
Sum fields 

Example 3-9, 5-6, 8-7 
Number 3-8, 5-6 
Overflow 3-8, 5-6 
Type 3-8, 5-6 
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Index- 3 



I Summing 1-1, 3-8, 5-6 
SUM parameter 3-8, D-2 
System-logical-record C- 



Termlnal 

Access (see Login) 
Connection 4-1 

TO parameter 3-2, D-2 



Value-set 

Description 3-2 

KEY parameter 3-2 

SUM parameter 3-8 
Value step 

SEQS parameter 3-6 

SM5SEQS procedure 5-5 
VER parameter (see VERIFY parameter) 
VERIFY parameter 3-9, D-2 



Unit record format 4-2 
Unsigned numeric data 2-2 
User-defined collating sequences 
SEQx parameters 3-5 
SM5SEQx procedures 5-5 



Word C-4 



$CHAR(n) 3-6 



Index-4 
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